Amele Forensic Tool

Collect digital evidence in one place. Disk, RAM, and Android acquisition.

Website | Releases | Contributing | Security | Linux Agent | Windows Agent

Overview

Amele is a desktop forensic acquisition tool for authorized investigations. It brings disk imaging, memory acquisition, Android collection, hash verification, case output handling, image viewing, and reporting into one native application.

The app runs as a real desktop window on Linux and Windows.

Features

• Local disk acquisition: create raw disk images from local disks or image files.
• Remote disk acquisition: collect disk images through the Linux and Windows agents.
• Local memory acquisition: capture RAM with AVML on Linux and WinPMEM on Windows.
• Remote memory acquisition: start, pause, resume, stop, track, and download RAM dumps from agents.
• Android tools: check ADB, list devices, collect logical data, collect filesystem data, capture volatile data, and analyze Android case outputs.
• Case management: store acquisitions, notes, hashes, Android outputs, and reports under selected cases.
• Hashing and verification: calculate MD5, SHA1, SHA256, and SHA512; generate sidecar hashes for acquired evidence.
• Image viewing: mount supported images read-only for inspection.
• Reports: create case reports from collected outputs and notes.
• Updates: check GitHub releases and download platform installers from inside the app.

Downloads

Release builds are published on GitHub Releases and on the website.

• Linux AppImage: amele-linux-x64.AppImage
• Linux DEB: amele-linux-x64.deb
• Linux RPM: amele-linux-x64.rpm
• Arch Linux package: amele-linux-x64.pkg.tar.zst
• Windows MSI: amele-windows-x64.msi

Agent binaries:

https://amele.noirlang.tr/amele-linux
https://amele.noirlang.tr/amele-win.exe

Build Requirements

Install the Rust stable toolchain:

rustup toolchain install stable --component rustfmt
rustup default stable

Linux development packages:

sudo apt update
sudo apt install -y build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev

Windows builds require the Microsoft Edge WebView2 Runtime on the target system.

Build

Debug build:

cargo build --locked

Release build:

cargo build --release --locked

Run tests and checks:

cargo test --locked
cargo fmt --all -- --check
node --check ui/app.js

Build the Linux AppImage:

./scripts/build-appimage.sh

Build Linux DEB, RPM, and Arch packages:

./scripts/build-linux-packages.sh

Run

Start the native desktop app:

cargo run -- ui

Run the release binary:

./target/release/amele ui

Open the browser-backed debug UI:

cargo run -- ui-browser

Agents

Run the Linux agent on the target machine:

wget -O amele-linux https://amele.noirlang.tr/amele-linux
chmod +x amele-linux
./amele-linux

Download the Windows agent:

https://amele.noirlang.tr/amele-win.exe

Connect to an agent from the app with IP address, port, and optional token.

CI/CD / Automated Builds

This project uses GitHub Actions for automated building and packaging.

To save runner resources, full builds and prereleases are only triggered when the commit message contains the [build] tag:

git commit -m "feat: add new feature [build]"

Commits without the [build] tag will be pushed to the dev branch but will not trigger build workflows.

Manual Build: You can also trigger the build workflow manually from the "Actions" tab in GitHub by clicking "Run workflow".

---

Amele Adli Bilişim Aracı (Forensic Tool)

Dijital delilleri tek bir yerde toplayın. Disk, RAM ve Android edinimi.

Web Sitesi | Sürümler | Katkıda Bulunma | Güvenlik | Linux Ajanı | Windows Ajanı

Genel Bakış

Amele, yetkili incelemeler için geliştirilmiş bir masaüstü adli edinim aracıdır. Disk imajı alma, bellek (RAM) edinimi, Android veri toplama, hash doğrulama, vaka çıktısı yönetimi, imaj görüntüleme ve raporlama özelliklerini tek bir yerel uygulamada bir araya getirir.

Uygulama Linux ve Windows üzerinde gerçek bir masaüstü penceresi olarak çalışır.

Özellikler

• Yerel disk edinimi: Yerel disklerden veya imaj dosyalarından ham (raw) disk imajları oluşturun.
• Uzak disk edinimi: Linux ve Windows ajanları (agents) aracılığıyla uzak disk imajları toplayın.
• Yerel bellek (RAM) edinimi: Linux üzerinde AVML ve Windows üzerinde WinPMEM ile RAM bellek kopyasını alın.
• Uzak bellek (RAM) edinimi: Ajanlar üzerinden RAM edinimini başlatın, duraklatın, sürdürün, durdurun, izleyin ve RAM dökümlerini indirin.
• Android araçları: ADB durumunu kontrol edin, cihazları listeleyin, mantıksal veri toplayın, dosya sistemi verisi toplayın, uçucu (volatile) verileri alın ve Android vaka çıktılarını analiz edin.
• Vaka yönetimi: Edinimleri, notları, hash değerlerini, Android çıktılarını ve raporları seçilen vakalar altında saklayın.
• Hash hesaplama ve doğrulama: MD5, SHA1, SHA256 ve SHA512 hesaplayın; elde edilen deliller için yan dosya (sidecar) hash dosyaları oluşturun.
• İmaj görüntüleme: Desteklenen imajları inceleme amacıyla salt okunur (read-only) olarak bağlayın (mount).
• Raporlar: Toplanan çıktılardan ve notlardan vaka raporları oluşturun.
• Güncellemeler: Uygulama içerisinden GitHub sürümlerini kontrol edin ve platform yükleyicilerini indirin.

İndirmeler

Kararlı sürümler GitHub Sürümleri (Releases) sayfasında ve web sitesinde yayınlanmaktadır.

• Linux AppImage: amele-linux-x64.AppImage
• Linux DEB: amele-linux-x64.deb
• Linux RPM: amele-linux-x64.rpm
• Arch Linux Paketi: amele-linux-x64.pkg.tar.zst
• Windows MSI: amele-windows-x64.msi

Ajan (Agent) ikili dosyaları:

https://amele.noirlang.tr/amele-linux
https://amele.noirlang.tr/amele-win.exe

Derleme Gereksinimleri

Stabil Rust araç zincirini (toolchain) kurun:

rustup toolchain install stable --component rustfmt
rustup default stable

Linux geliştirme paketleri:

sudo apt update
sudo apt install -y build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev

Windows derlemeleri, hedef sistemde Microsoft Edge WebView2 Çalışma Zamanı (Runtime) gerektirir.

Derleme

Geliştirici (Debug) derlemesi:

cargo build --locked

Kararlı (Release) derlemesi:

cargo build --release --locked

Testleri ve kontrolleri çalıştırın:

cargo test --locked
cargo fmt --all -- --check
node --check ui/app.js

Linux AppImage derleme:

./scripts/build-appimage.sh

Linux DEB, RPM ve Arch paketlerini derleme:

./scripts/build-linux-packages.sh

Çalıştırma

Yerel masaüstü uygulamasını başlatın:

cargo run -- ui

Kararlı ikili dosyayı çalıştırın:

./target/release/amele ui

Tarayıcı tabanlı hata ayıklama arayüzünü (debug UI) açın:

cargo run -- ui-browser

Ajanlar (Agents)

Hedef makinede Linux ajanını çalıştırın:

wget -O amele-linux https://amele.noirlang.tr/amele-linux
chmod +x amele-linux
./amele-linux

Windows ajanını indirin:

https://amele.noirlang.tr/amele-win.exe

IP adresi, port ve isteğe bağlı token ile uygulama içerisinden ajana bağlanın.

CI/CD / Otomatik Derlemeler

Bu proje, otomatik derleme ve paketleme işlemleri için GitHub Actions kullanmaktadır.

Sunucu (runner) kaynaklarını tasarruflu kullanmak amacıyla, tam sürüm derlemeleri ve ön sürümler (prerelease) yalnızca commit mesajı [build] etiketini içerdiğinde tetiklenir:

git commit -m "feat: add new feature [build]"

[build] etiketi içermeyen commit'ler dev dalına pushlanır ancak derleme iş akışlarını tetiklemez.

Manuel Derleme: GitHub'daki "Actions" sekmesinden "Run workflow" seçeneğine tıklayarak derleme iş akışını manuel olarak da tetikleyebilirsiniz.