_    _ _____ __  __ _____ ____      _    _
    / \  | |_   _|  \/  | ____|  _ \    / \  | |
   / _ \ | | | | | |\/| |  _| | |_) |  / _ \ | |
  / ___ \| | | | | |  | | |___|  _ <  / ___ \| |___
 /_/   \_\_| | |_|_|  |_|_____|_| \_/_/   \_\_____|

✨ Fitur

📋 Persyaratan

🚀 Instalasi

Metode 1: npm (Paling Mudah — Auto-install Python + Dependencies)

npm install -g aitmeral
# Atau one-line via curl:
curl -fsSL https://raw.githubusercontent.com/ZetaGo-Aurum/Aitmeral/main/npm-wrapper/install-npm.sh | bash

Metode 2: Universal Installer (Coba npm → pip → source)

curl -fsSL https://raw.githubusercontent.com/ZetaGo-Aurum/Aitmeral/main/install-universal.sh | bash

Metode 3: Pip (Python Native)

pip install aitmeral
# Dengan fitur YouTube:
pip install "aitmeral[youtube]"

Metode 4: Dari Source (Development)

git clone https://github.com/ZetaGo-Aurum/Aitmeral.git
cd Aitmeral
pip install -e .
# Atau jalankan helper:
bash install.sh

1. Siapkan dependensi sistem (hanya untuk metode pip/source)

# Linux (Debian/Ubuntu)
sudo apt install ffmpeg python3-pip
pip install yt-dlp            # atau: sudo apt install yt-dlp

# Linux (Fedora)                # Linux (Arch)
sudo dnf install ffmpeg python-pip    sudo pacman -S ffmpeg python-pip
pip install yt-dlp                   pip install yt-dlp

# macOS (Homebrew)
brew install ffmpeg yt-dlp python

# Windows (winget)
winget install Gyan.FFmpeg yt-dlp.yt-dlp Python.Python.3.12

# Termux (Android)
pkg update && pkg install ffmpeg python git
pip install yt-dlp

2. Pasang AITMERAL

Dari folder source ini:

pip install .            # dasar (TUI + CLI + Web)
pip install ".[youtube]" # sekalian memasang yt-dlp
# atau mode development:
pip install -e .

Atau cukup jalankan helper: bash install.sh

Verifikasi:

aitmeral -V
aitmeral doctor     # cek RAM, ffmpeg, yt-dlp, encoder & filter

Sebagai alternatif tanpa instalasi: python -m aitmeral --help dari root folder project.

🖥️ Cara Pakai

TUI interaktif (default)

aitmeral            # langsung membuka TUI
aitmeral tui        # sama dengan di atas

Panel TUI: Dashboard · File Manager (browser folder + detail probe) · Enhance & Convert (preset, efek, shader) · URL Grabber (YouTube/embed) · Jobs/Queue (progress live) · System Info. Shortcut: 1–6 pindah panel, q keluar, mouse sepenuhnya didukung.

Screenshot ada di folder docs/.

Web UI lokal

aitmeral server                       # buka http://127.0.0.1:8765
aitmeral server --port 9000 --host 0.0.0.0
aitmeral server --output-dir /mnt/hdd/renders --no-open

Fitur web: paste link YouTube/embed → check info → pilih preset & efek → START ENHANCE, upload file (drag & drop), file browser server, progress bar live, preview video hasil, download langsung.

CLI

aitmeral --help
aitmeral -h

# File lokal: 480p → 1080p, output paling raw (FFV1 lossless)
aitmeral convert video480.mp4 -S 1080p -p raw --effects denoise:2,sharpen:0.5

# File lokal: hasil paling kompatibel untuk semua device
aitmeral convert video.mp4 -S 1080p -p superhd --effects all

# Dari YouTube (termasuk link embed) → lossless
aitmeral url "https://www.youtube.com/watch?v=XXXX" -S 1080p -p lossless-x264
aitmeral url "https://www.youtube.com/embed/XXXX"   -S 2160p -p hdr10 --hdr

# SDR → HDR 4K
aitmeral convert video.mp4 -S 2160p -p hdr10 --hdr --effects sharpen:0.5,denoise:1

# Inspeksi media / URL
aitmeral info video.mp4
aitmeral info "https://youtu.be/XXXX"

# Lihat rencana perintah ffmpeg tanpa menjalankan
aitmeral convert video.mp4 -S 1080p -p raw --dry-run

aitmeral presets      # daftar 10 preset output
aitmeral effects      # daftar efek & shader
aitmeral doctor       # cek sistem

Flag penting aitmeral convert / url

🎚 Preset Output (aitmeral presets)

🎛 Efek & Shader (aitmeral effects)

📡 Catatan HDR

• SDR→HDR bekerja dengan mengonversi ke cahaya linear → BT.2020 → PQ (SMPTE 2084) lewat zimg, lalu memberi sinyal metadata HDR10 pada stream HEVC. Hasil terbaik diputar di display HDR; di display SDR warna bisa terlihat pudar (wajar, karena butuh decoding HDR).
• Sumber HDR dideteksi otomatis: preset RAW/lossless menyimpannya tetap sebagai HDR 10-bit; preset 8-bit (mis. superhd) otomatis tone-map ke SDR BT.709.
• Build ffmpeg tanpa zscale tetap didukung — AITMERAL otomatis fallback ke 10-bit + signaling metadata (cek dengan aitmeral doctor).

⚠️ Catatan jujur soal "RAW"

• Preset raw/y4m/lossless-* menjamin tidak ada degradasi sama sekali dari hasil proses enhancement — cocok untuk arsip, re-encode berkali-kali, atau editing.
• Upscale tidak bisa menciptakan detail yang memang tidak ada di video sumber; yang AITMERAL lakukan adalah menaikkan resolusi dengan algoritma terbaik + menjernihkan + menjaga setiap piksel hasilnya secara lossless.
• File RAW itu BESAR. 10 menit video 1080p bisa 20–80 GB (Y4M). Untuk distribusi ke HP/TV gunakan superhd atau hq-hevc.

🧰 Troubleshooting

🏗 Struktur Proyek

aitmeral/
├── aitmeral/
│   ├── cli.py               # CLI (argparse) — aitmeral --help
│   ├── core/
│   │   ├── options.py       # Settings — kontrak tunggal CLI/TUI/Web
│   │   ├── presets.py       # 10 preset output + efek
│   │   ├── filters.py       # pembangun filter-graph (upscale/shader/HDR)
│   │   ├── encoder.py       # konstruksi & eksekusi ffmpeg + progress
│   │   ├── downloader.py    # yt-dlp (link embed/shorts di-normalisasi)
│   │   ├── media.py         # ffprobe wrapper
│   │   ├── pipeline.py      # orkestrasi (gate RAM → download → enhance)
│   │   ├── jobs.py          # job engine (dipakai TUI & Web)
│   │   └── sysinfo.py       # deteksi platform/RAM/kapabilitas
│   ├── tui/app.py           # TUI Textual (file manager, queue live)
│   └── web/
│       ├── server.py        # web server stdlib (upload, range, API)
│       └── static/index.html# UI web (tanpa dependensi eksternal)
├── docs/                    # screenshot TUI (SVG)
├── install.sh
└── pyproject.toml

⚖️ Lisensi & Etika

MIT License. Gunakan hanya untuk konten yang Anda miliki haknya — mengunduh materi berhak cipta dari YouTube/situs lain tanpa izin dapat melanggar ketentuan layanan mereka dan hukum yang berlaku.