# Arroxy — Windows, macOS ve Linux için Ücretsiz Açık Kaynak YouTube (+ 2000 site) İndirici
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Şu dilde oku:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Kiswahili](README.sw.md) · [O'zbekcha](README.uz.md) · [Polski](README.pl.md) · [Português](README.pt.md) · [Tiếng Việt](README.vi.md) · **Türkçe** · [አማርኛ](README.am.md) · [العربية](README.ar.md) · [اردو](README.ur.md) · [پښتو](README.ps.md) · [فارسی](README.fa.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [ไทย](README.th.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · [Українська](README.uk.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-Hant.md)
[](https://github.com/antonio-orionus/Arroxy/releases/latest) [](https://github.com/antonio-orionus/Arroxy/actions/workflows/release.yml) [](https://arroxy.orionus.dev/)   
**YouTube ve 2000+ desteklenen siteden** video, Shorts, müzik, kanal, podcast veya ses parçaları indir — 60 fps'de 4K HDR'a kadar ya da MP3 / AAC / Opus olarak. Windows, macOS ve Linux'ta yerel çalışır. **Reklam yok, şişkinlik yok, ek satış yok.**
[**↓ En son sürümü kur**](#install) · [**Web sitesi**](https://arroxy.orionus.dev/) · [Windows ilk başlatma](#windows-first-launch) · [macOS ilk başlatma](#macos-first-launch) · [Linux ilk başlatma](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Arroxy sana zaman kazandırıyorsa, bir ⭐ başkalarının onu bulmasına yardım eder.
> **What is Arroxy?** Arroxy is a free, open-source desktop GUI that downloads videos, audio, playlists, and subtitles from YouTube and 2000+ other [yt-dlp](https://github.com/yt-dlp/yt-dlp)-supported sites. It runs on Windows 10/11, macOS 11+ (Intel + Apple Silicon), and Linux (AppImage, Flatpak, tar.gz). MIT licensed. No account, no ads, no usage limits. Distributed via [Winget](https://winget.run/pkg/AntonioOrionus/Arroxy), [Scoop](https://github.com/antonio-orionus/scoop-bucket), [Homebrew Cask](https://github.com/antonio-orionus/homebrew-arroxy), Flatpak, AppImage, and direct download.
>
> _Last updated: 2026-09-14._
> 🌐 Bu, yapay zeka destekli bir çeviridir. [İngilizce README](README.md) gerçek kaynak kabul edilir. Hata mı gördün? [PR'lar memnuniyetle karşılanır](../../pulls).
---
## İçindekiler
- [Kurulum ve ilk başlatma](#install)
- [Windows ilk başlatma](#windows-first-launch)
- [macOS ilk başlatma](#macos-first-launch)
- [Neden uyarı görebilirsin](#why-warning)
- [Linux ilk başlatma](#linux-first-launch)
- [İndirmeni doğrula (SHA256)](#verify)
- [Neden Arroxy](#why)
- [Özellikler](#features)
- [Gizlilik](#privacy)
- [SSS](#faq)
- [Yol haritası](#roadmap)
- [Arroxy'yi destekle](#support)
- [Kullanılan teknolojiler](#tech)
---
## Kurulum ve ilk başlatma
**Windows**
```bash
winget install AntonioOrionus.Arroxy
```
**macOS**
```bash
brew install --cask antonio-orionus/arroxy/arroxy
```
**Linux**
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh
```
Linux betiği indirmeyi yayımlanan `SHA256SUMS` ile doğrular ve Arroxy'yi uygulama menünüze ekler. Sürümler yalnızca x86_64'tür. `curl` yok mu? `curl -fsSL` yerine `wget -qO-` kullanın.
| Platform | Doğrudan indirme |
| --- | --- |
| Windows | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Setup.exe) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Portable.exe) |
| macOS | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-arm64.dmg) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-x64.dmg) |
| Linux | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.AppImage) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.flatpak) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.tar.gz) |
| Verify | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/SHA256SUMS) |
[**Tüm sürüm dosyaları →**](https://github.com/antonio-orionus/Arroxy/releases/latest)
### Windows ilk başlatma
İlk başlatmada **"Windows bilgisayarınızı korudu"** veya **"Bilinmeyen yayımcı"** görebilirsin. Bu hem `Arroxy-win-x64-Setup.exe` hem de `Arroxy-win-x64-Portable.exe` için geçerlidir. Arroxy ücretsiz ve açık kaynaklıdır; Windows derlemeleri ücretli bir sertifikayla kod imzalı değildir, SmartScreen bu yüzden işaretler. Bu, Arroxy’nin otomatik olarak güvensiz olduğu anlamına gelmez. Devam etmek için:
1. **Daha fazla bilgi** seçeneğine tıkla.
2. **Yine de çalıştır** seçeneğine tıkla.
#### Windows Defender dosyayı işaretler veya kaldırırsa
Defender sezgisel kuralları bazen imzasız NSIS kurucuları ve Electron taşınabilirlerini şüpheli olarak işaretler. Defender `Arroxy-win-x64-Setup.exe` veya `Arroxy-win-x64-Portable.exe` dosyasını karantinaya alırsa **Windows Güvenliği → Virüs ve tehdit koruması → Koruma geçmişi** içinden geri yükle, sonra Arroxy yürütülebilir dosyasını **Ayarları yönet → Dışlamalar ekle veya kaldır** altında izin verilen öğe olarak ekle. SmartScreen'de olduğu gibi tetikleyici eksik yayımcı imzasıdır, tespit edilmiş kötü amaçlı yazılım değil.
> Arroxy'yi yalnızca resmi GitHub Releases sayfasından indir. Dosyayı başka bir web sitesinden aldıysan veya biri sana gönderdiyse sil ve resmi kaynaktan yeni kopya indir. Kaynak kodu herkese açık; istersen inceleyebilir veya Arroxy'yi kendin derleyebilirsin.
Scoop mu tercih edersiniz? `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### macOS ilk başlatma
Arroxy henüz macOS için kod imzalı değildir, bu yüzden Gatekeeper DMG'den kurduktan sonra korkutucu *"Arroxy.app is damaged and can't be opened"* penceresini gösterebilir. Bu mesaj macOS'un imzasız uygulamayı karantinaya aldığı anlamına gelir; uygulama dosyalarının gerçekten hasarlı olduğu anlamına gelmez. Güncel macOS'ta güvenilir çözüm Terminal'dir:
1. Bağlanan DMG'den `Arroxy.app` dosyasını `/Applications` içine sürükle.
2. Terminal'i aç ve şu iki komutu çalıştır:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
İlk komut kurulu Arroxy kopyandan karantina özniteliğini kaldırır. İkinci komut uygulamayı başlatır. `sudo` Mac parolanı isteyebilir; Terminal yazarken karakterleri göstermez.
**Apple Silicon ve Intel:** M serisi Mac'te (M1 / M2 / M3 / M4) `arm64` DMG indir. Intel Mac'lerde `x64` DMG indir. Yanlış derleme Rosetta ile çalışır ama belirgin şekilde daha yavaştır.
> macOS derlemeleri Apple Silicon ve Intel CI runner'larında üretilir. Sorun yaşarsan lütfen [issue aç](../../issues) — macOS kullanıcılarından gelen geri bildirim macOS test döngüsünü doğrudan şekillendirir.
### Neden uyarı görebilirsin
Arroxy açık kaynaklı ve MIT lisanslıdır. Windows ve macOS derlemeleri **kod imzalı değildir** — Apple Developer ID ve Windows EV kod imzalama sertifikalarının her biri yılda yüzlerce dolara mal olur; bağımsız bir proje bunu cebinden öder. Bu imzalar olmayınca Windows SmartScreen ve macOS Gatekeeper ilk başlatmada uyarır. Uyarılar *işletim sisteminin yayımcıyı tanımadığı* anlamına gelir — Arroxy'nin kötü amaçlı yazılım olduğu anlamına gelmez.
Arroxy'yi kendin doğrulamanın giderek daha sıkı üç yolu:
- **Kaynağı oku.** Her satır [GitHub](https://github.com/antonio-orionus/Arroxy) üzerinde ve [kaynaktan derleyebilirsin](#tech).
- **SHA256 kontrol et.** Dosyanı yayımlanan [`SHA256SUMS`](https://github.com/antonio-orionus/Arroxy/releases/latest/download/SHA256SUMS) ile eşleştir — aşağıdaki [İndirmeni doğrula](#verify) bölümüne bak.
- **Üçüncü taraf taraması yap.** Dosyayı [VirusTotal](https://www.virustotal.com) üzerine yükle.
### Linux ilk başlatma
AppImage'lar doğrudan çalışır — kurulum gerekmez. Sadece dosyayı yürütülebilir olarak işaretlemen gerekir.
**Dosya yöneticisi:** `.AppImage` üzerine sağ tık → **Özellikler** → **İzinler** → **Dosyayı program olarak çalıştırmaya izin ver** seçeneğini aç, sonra çift tıkla.
**Terminal:**
```bash
chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage
```
Açılış hâlâ başarısızsa bağlamadan çalıştırın — FUSE paketi gerekmez:
```bash
./Arroxy-linux-x64.AppImage --appimage-extract-and-run
```
**İsteğe bağlı masaüstü entegrasyonu:** [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) bir kez kurulduğunda, çift tıkladığın her AppImage otomatik olarak başlatıcı menüne kaydolur — elle `.desktop` dosyası gerekmez.
**Düz arşiv (FUSE yok, kurulum yok):**
`.tar.gz` sürümü, AppImage sarmalayıcısı olmayan aynı uygulamadır — istediğiniz yere çıkarın ve çalıştırın. Kurulum programı ve FUSE paketi gerekmez.
```bash
tar xzf Arroxy-linux-x64.tar.gz
./Arroxy-linux-x64/arroxy
```
**Flatpak (sandbox'lı alternatif):** aynı sürüm sayfasından `Arroxy-linux-x64.flatpak` indir.
Ubuntu, Flatpak yerine Snap ile gelir; bu yüzden önce Flatpak'i kurun ve Flathub'ı ekleyin — paket çalışma zamanını oradan indirir:
```bash
# Ubuntu / Debian
sudo apt install -y flatpak
# Fedora
sudo dnf install -y flatpak
# Arch
sudo pacman -S flatpak
```
```bash
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user ./Arroxy-linux-x64.flatpak
flatpak run io.github.antonio_orionus.Arroxy
```
**Sürüm sayfasındaki Linux indirmeleri yalnızca x86_64'tür.** ARM64 makinelerde (Raspberry Pi, Asahi Linux) Flatpak kurulur ama açılışta `bwrap: execvp ldconfig: Exec format error` hatasıyla başarısız olur.
İndirmeni doğrula (SHA256)
Her sürüm ikili dosyaların yanında bir `SHA256SUMS` dosyası yayımlar. İndirmenin aktarım sırasında bozulmadığını veya değiştirilmediğini kontrol etmek için dosyanı yerel olarak hash'le ve `SHA256SUMS` içindeki satırla eşleştir. En son sürüm sayfasını aç → **Assets** → `SHA256SUMS` indir.
**Windows (PowerShell veya Komut İstemi):**
```powershell
certutil -hashfile Arroxy-win-x64-Setup.exe SHA256
```
**macOS (Terminal):**
```bash
shasum -a 256 Arroxy-mac-arm64.dmg
```
**Linux (Terminal):**
```bash
sha256sum Arroxy-linux-x64.AppImage
```
Üçüncü taraf kötü amaçlı yazılım taraması ister misin? Dosyayı [VirusTotal](https://www.virustotal.com) üzerine yükle. İmzasız Electron uygulamaları için küçük motorlardan gelen birkaç genel sezgisel uyarı normaldir; büyük motorlardan yaygın tespitler gerçek bir endişe olurdu.
Windows: Kurucu mu Taşınabilir mi
| | NSIS Kurucu | Taşınabilir `.exe` |
| ------------- | :----------------------: | :---------------------: |
| Kurulum gerekli | Evet | Hayır — her yerden çalıştır |
| Otomatik güncellemeler | ✅ uygulama içinde | ❌ elle indirme |
| Başlangıç hızı | ✅ daha hızlı | ⚠️ soğuk başlangıç daha yavaş |
| Başlat Menüsüne ekler | ✅ | ❌ |
| Kolay kaldırma | ✅ | ❌ dosyayı sil |
**Öneri:** otomatik güncellemeler ve daha hızlı başlangıç için NSIS kurucuyu kullan. Kurulum yapmadan, kayıt defterine dokunmadan kullanmak için taşınabilir `.exe` uygundur.
---
## Neden Arroxy
En yaygın alternatiflerle yan yana karşılaştırma:
| | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions |
| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |
| Ücretsiz, premium katman yok | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| Açık kaynak | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| Yalnızca yerel işleme | ✅ | ✅ | ✅ | ❌ | ✅ |
| Giriş veya çerez dışa aktarma yok | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ |
| Kullanım sınırı yok | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ |
| Platformlar arası masaüstü uygulaması | ✅ | ✅ | ✅ | N/A | ❌ |
| Altyazılar + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ |
Arroxy tek bir şey için yapılmıştır: URL yapıştır, temiz bir yerel dosya al. Hesap yok, ek satış yok, veri toplama yok.
---
## Özellikler
### Kalite ve biçimler
- **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p'ye kadar
- **Yüksek kare hızı** olduğu gibi korunur — 60 fps, 120 fps, HDR
- **Ses** — yalnızca sesi MP3, M4A/AAC, Opus veya WAV olarak dışa aktar. Etkileşimli indirmelerde varsa kaynağın yerel surround/Dolby parçalarını (AC-3, E-AC-3, 5.1, DRC) seç veya genel **Surround / Dolby tercih et** varsayılanı ayarla
- Hızlı ön ayarlar: *En iyi kalite* · *Dengeli* · *Küçük dosya*
### Gizlilik ve kontrol
- %100 yerel işleme — indirmeler doğrudan YouTube'dan diskine gider
- **Açık kaynak** — her satır denetlenebilir, MIT lisanslı
- Dosyalar doğrudan seçtiğin klasöre kaydedilir
### İş akışı
- **Genel indirme kısayolu** — herhangi bir uygulamada bir bağlantı kopyala ve `Ctrl+Shift+D` (macOS'ta `Cmd+Shift+D`) tuşlarına bas; Arroxy pencereyi açmadan aktif profilinle kuyruğa ekler ve bir bildirim bunu doğrular. Varsayılan olarak açık, yeniden atanabilir
- **Esnek başlangıç modları** — rehberli tek indirme, oynatma listesi/kanal seçici, toplu URL yapıştırma veya kayıtlı varsayılanlarla Hızlı İndirme seç
- **Merkezi indirme kuyruğu** — her tekil, oynatma listesi, toplu veya hızlı iş; ilerleme, duraklatma, sürdürme, iptal, yeniden deneme ve öncelik kontrolü için tek yere gelir
- **Pano izleme** — bir YouTube bağlantısı kopyala; uygulamaya tekrar odaklandığında Arroxy URL'yi otomatik doldurur (Gelişmiş ayarlardan aç)
- **Otomatik URL temizleme** — izleme parametrelerini (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) kaldırır ve `youtube.com/redirect` bağlantılarını çözer
- **Tepsi modu** — pencere kapansa bile indirmeler arka planda sürer
- **30 dil** — sistem dilini otomatik algılar, istediğin zaman değiştirilebilir
- **Oynatma listesi eşitleme** — zaten indirilmiş videoları atlamak için bir oynatma listesini yerel klasöre karşı yeniden tara; her indirilen videoyla güncellenen bir `.m3u` oynatma listesi dosyası oluşturur
- **Hız ve tempo kontrolleri** — indirme bant genişliğini sınırla, bir videonun aynı anda kaç parçasının indirileceğini ayarla ve ön ayarlarla istek gecikmeleri ekle (*Kapalı · Dengeli · Dikkatli · Özel*)
- **Dosya adı şablonları** — indirmelerinizi `{title}`, `{uploader}`, `{id}`, `{date}`, `{resolution}` ve `{playlist_index}` ile dilediğiniz gibi adlandırın; genel olarak veya indirme profili başına
- **Aynı anda indirme ve otomatik yeniden deneme** — kuyruktaki kaç indirmenin aynı anda çalışacağını seç ve ağ ya da sunucu kaynaklı sorun yaşayan bir indirmeyi Arroxy'nin, her denemeden önce daha uzun bekleyerek yeniden denemesine izin ver
- **Oynatma listesinde öğe başına profil** — bir oynatma listesindeki her videoya, tüm liste için tek bir ayar yerine kendi indirme profilini atayın; böylece tek geçişte bazılarını tam kalitede arşivleyip kalanını MP3 olarak alabilirsiniz
### Altyazılar ve son işleme
- **Altyazılar** SRT, VTT veya ASS olarak — manuel ya da otomatik oluşturulmuş, mevcut herhangi bir dilde
- Videonun yanına kaydet, `.mkv` içine göm veya `Subtitles/` alt klasöründe düzenle
- **SponsorBlock** — sponsorları, intro'ları, outro'ları ve öz tanıtımları atla ya da bölüm olarak işaretle
- **Gömülü meta veriler** — başlık, yükleme tarihi, kanal, açıklama, küçük resim ve bölüm işaretleri dosyaya yazılır
### YouTube + 2000 site
- **YouTube, tam kapsamlı** — Videolar, Shorts, Kanallar, Oynatma Listeleri, YouTube Music ve Podcast'ler birinci sınıf kaynak olarak ele alınır
- **yt-dlp aracılığıyla 2000+ diğer site** — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org ve daha fazlası
- **Yalnızca ses ve altyazılar** yalnızca YouTube'da değil, desteklenen her sitede çalışır
- Bir site değişirse yt-dlp haftalık düzeltmeler yayınlar ve Arroxy açılışta ikili dosyayı otomatik günceller
Genel indirme kısayolu Bağlantıyı nerede olursan ol kopyala, bir kez bas — kuyruğa girer ve inmeye başlar
Oynatma listesinde öğe başına profil Her videoya kendi profilini ver — bazılarını 4K arşivle, kalanını MP3 olarak al
Hızlı İndirme ana ekranı Bir URL yapıştır ve etkin profilinle anında çek
Yeniden kullanılabilir indirme profilleri Biçim, kalite ve çıktı ön ayarlarını kaydet — her indirmede yeniden kullan
Çok dilli ses parçaları Videonun sunduğu tam ses dilini seç
Surround / Dolby ses 5.1 ve Dolby parçaları algılanır ve korunur
Toplu URL modu Bir liste yapıştır, otomatik tekilleştir, hepsini tek seferde kuyruğa al
Paralel indirme kuyruğu Canlı ilerlemeyle aynı anda birden fazla indirme
---
## Gizlilik
İndirmeler [yt-dlp](https://github.com/yt-dlp/yt-dlp) ile doğrudan YouTube'dan seçtiğin klasöre alınır — hiçbir şey üçüncü taraf sunucu üzerinden yönlendirilmez. İzleme geçmişi, indirme geçmişi, URL'ler ve dosya içerikleri cihazında kalır.
Arroxy [OpenPanel](https://openpanel.dev) üzerinden anonim, toplu telemetri gönderir — bağımsız bir projenin hataları, çökmeleri, geri bildirimleri, işletim sistemlerini ve uygulama sürümlerini anlamasına yetecek kadar. URL, video başlığı, dosya yolu, hesap bilgisi, parmak izi veya kişisel veri yoktur. Kurulum başına kimlik rastgeledir ve kimliğinle bağlantılı değildir. Ayarlar'dan çıkabilirsin.
---
## SSS
**Gerçekten ücretsiz mi?**
Evet — MIT lisanslı, premium katman yok, özellik kilidi yok.
**Hangi video kalitelerini indirebilirim?**
YouTube ne sunuyorsa: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p ve yalnızca ses. 60 fps, 120 fps ve HDR akışlar olduğu gibi korunur.
**Yalnızca sesi MP3 olarak çıkarabilir miyim?**
Evet. Biçim menüsünde *yalnızca ses* seç ve MP3, M4A/AAC, Opus veya WAV tercih et.
**YouTube hesabı veya çerez gerekir mi?**
Varsayılan olarak hayır — Arroxy YouTube hesabı, giriş veya çerez dışa aktarma olmadan çalışır. Yaş kısıtlamalı veya üyelere özel videolar gibi kimlik doğrulaması gerektiren içerikler için Gelişmiş ayarlarda isteğe bağlı çerez desteği vardır (Çerez kaynağı: dosya veya tarayıcı). Varsayılan olarak kapalıdır. Etkinleştirirsen yt-dlp wiki'si [çerez tabanlı otomasyonun bir Google hesabını işaretleyebileceğini](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies) belirtir; bu durumda geçici bir hesap daha güvenlidir.
**YouTube bir şey değiştirdiğinde çalışmaya devam eder mi?**
yt-dlp açılışta otomatik güncellenir ve YouTube bir şey değiştirdiğinde Arroxy hızlıca düzeltme yayımlar. Yine de sorun yaşarsan Gelişmiş ayarlarda isteğe bağlı çerez desteği yedek yol olarak kullanılabilir.
**Arroxy hangi dillerde mevcut?**
Kutudan çıktığı gibi 30 dil: Afaan Oromoo · Bahasa Indonesia · Deutsch · English · Español · Français · Italiano · Kiswahili · O'zbekcha · Polski · Português · Tiếng Việt · Türkçe · አማርኛ · العربية · اردو · پښتو · فارسی · বাংলা · हिन्दी · ไทย · မြန်မာဘာသာ · Ελληνικά · Русский · Српски · Українська · 中文 · 日本語 · 한국어 · 繁體中文. Arroxy ilk açılışta işletim sisteminin dilini otomatik algılar ve araç çubuğundaki dil seçiciden istediğin zaman değiştirebilirsin. Çalışma zamanı locale JSON dosyaları src/shared/i18n/locales/ içinde, çevirmenlere yönelik PO katalogları i18n/locales/ içinde bulunur — katkı için GitHub'da PR aç.
**Başka bir şey kurmam gerekir mi?**
Hayır. yt-dlp ilk açılışta otomatik indirilir ve makinede önbelleğe alınır; ffmpeg ve ffprobe uygulamayla gelir. Bundan sonra ek kurulum gerekmez.
**Oynatma listeleri veya tüm kanalları indirebilir miyim?**
Evet — ikisi de. Bir oynatma listesi URL'si veya kanal URL'si yapıştır (örn. `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); kaç kayıt taranacağını seç, sonra tüm listeyi kuyruğa al veya belirli videoları seç. Tarih aralığı filtreleri yakında geliyor.
**macOS "uygulama hasarlı" diyor — ne yapmalıyım?**
Bu, macOS Gatekeeper’ın imzasız uygulamayı engellemesidir; gerçek hasar değildir. Karantinayı kaldırıp Arroxy’yi başlatan Terminal komutları için [macOS ilk başlatma](#macos-first-launch) bölümüne bak.
**YouTube videoları indirmek yasal mı?**
Kişisel, özel kullanım için çoğu yargı alanında genellikle kabul edilir. YouTube'un [Hizmet Şartları](https://www.youtube.com/t/terms) ve yerel telif hakkı yasalarına uymaktan sen sorumlusun.
---
## Yol haritası
Hâlâ planlananlar — yaklaşık öncelik sırasıyla:
| Özellik | Açıklama |
| ---------------- | ---------------- |
| **Oynatma listesi ve kanal filtreleri** | Bir oynatma listesi veya kanal listelenirken tarih aralığı filtreleri |
| **YouTube ses parçası tercihleri** | YouTube birden fazla ses parçası sunduğunda profil bazlı geçersiz kılmalarla birlikte uygulama geneli konuşulan dil tercihi ayarla |
| **Uygulama içi tarayıcı oturumu** | Elle dışa aktarma olmadan oturum açıp site çerezlerini kullanabilmen için Arroxy içinde tarayıcı pencereleri aç |
| **Tek tıkla video indirme** | Algılanan veya yapıştırılan URL’den etkin profilini kullanarak tek tıkla video indirmesi başlat |
| **Daha güçlü yeniden deneme kurtarması** | Güvenilmez veya sorunlu internet bağlantılarıyla kesilen indirmeler için yeni bir yeniden deneme yolu |
| **Tam indirme yöneticisi çekmecesi** | Kuyruk çekmecesini, kuyruktaki öğelerin hedef klasörlerini değiştirme dahil daha kapsamlı bir yöneticisine dönüştür |
| **Zamanlanmış indirmeler** | Bir kuyruğu belirli saatte başlat (gece çalıştırmaları) |
| **Klip kırpma** | Yalnızca başlangıç/bitiş zamanıyla belirli bir segmenti indir |
Aklında bir özellik mi var? [İstek aç](../../issues) — topluluk girdisi önceliği şekillendirir.
---
## Arroxy'yi destekle
Arroxy ücretsizdir ve MIT lisanslıdır — reklam yok, ücretli sürüm yok. Sana zaman kazandırıyorsa geliştirmeyi Bitcoin veya Tron ile destekleyebilirsin: adresler, tek resmi kaynak olan [DONATE.md](DONATE.md) dosyasında. Arroxy sana asla e-posta veya özel mesajla adres göndermez. Depoya yıldız vermek, hata bildirmek ve çevirileri iyileştirmek de en az o kadar yardımcı olur.
---
## Kullanılan teknolojiler
Teknoloji yığını
- **Electron** — platformlar arası masaüstü kabuğu
- **React 19** + **TypeScript** — kullanıcı arayüzü
- **Tailwind CSS v4** — stillendirme
- **Zustand** — durum yönetimi
- **yt-dlp** + **ffmpeg** — indirme ve mux motoru (yt-dlp çalışma zamanında alınır; ffmpeg/ffprobe derleme zamanında paketlenir)
- **Vite** + **electron-vite** — derleme araçları
- **Vitest** + **Playwright** — birim ve uçtan uca testler
Kaynaktan derle
### Ön koşullar — tüm platformlar
| Araç | Sürüm | Kurulum |
| ------- | ------- | ------- |
| Git | herhangi | [git-scm.com](https://git-scm.com) |
| Node.js | 24.16.0 | `mise install` veya `.node-version` |
| Bun | 1.2.23 | `mise install` veya `package.json` `packageManager` |
Önerilen: `mise` kur, sonra checkout içinde `mise install` çalıştır. mise olmadan, `bun run bootstrap` öncesinde Node.js'i `.node-version` üzerinden ve Bun'ı `package.json` üzerinden elle etkinleştir.
### Windows
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
Yerel yeniden derlemeler için Visual Studio Build Tools ve Python gerekebilir.
### macOS
```bash
brew install mise
xcode-select --install
```
Klonladıktan sonra checkout içinde `mise trust && mise install` çalıştır. Shell'in zaten `fnm`, `nvm` veya Homebrew Bun kullanıyorsa, Arroxy'nin Node.js 24.16.0 ve Bun 1.2.23 alması için `~/.zshrc` içinde mise'i etkinleştir:
```bash
printf '
# mise
if command -v mise >/dev/null 2>&1; then
eval "$(mise activate zsh)"
fi
' >> ~/.zshrc
exec zsh
```
### Linux (Ubuntu / Debian)
```bash
curl -fsSL https://bun.sh/install | bash
# Derleme + Electron çalışma zamanı bağımlılıkları
sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64
# Yalnızca E2E testleri için (Electron bir ekran ister)
sudo apt install -y xvfb
```
### Klonla ve çalıştır
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # önerilir; sabitlenmiş araçları elle etkinleştirdiysen atla
bun run bootstrap
bun run doctor
bun run dev # Vite renderer'a karşı Electron uygulaması
```
### Dağıtılabilir paket derle
```bash
bun run build # typecheck + compile
bun run dist # geçerli işletim sistemi için paketle
bun run dist:win # desteklenen bir host üzerinde Windows hedeflerini paketle
```
> `bun run bootstrap` bağımlılıkları kurar, Electron uygulama bağımlılıklarını yeniden derler, Electron'u doğrular, geliştirme için gömülü ffmpeg/ffprobe hazırlar ve Playwright Chromium kurar. yt-dlp uygulama veri klasöründe çalışma zamanında yönetilir; ffmpeg ve ffprobe her Arroxy sürümüyle paketlenir.
---
## Troubleshooting
### App won't open / no window appears
The Arroxy process starts but no window shows up. Most often this is a GPU driver hang during startup. Try, in order:
**1. Check the log.** It records startup, GPU info, and any crash. Path:
| Platform | Path |
| -------- | -------------------------------- |
| Windows | `%APPDATA%\Arroxy\logs\main.log` |
| macOS | `~/Library/Logs/Arroxy/main.log` |
| Linux | `~/.config/Arroxy/logs/main.log` |
**2. Launch with hardware acceleration disabled.** Open a terminal / Command Prompt and run the executable with a flag:
```bash
# Windows (Portable) — PowerShell, run from the folder containing the exe
.\Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Portable) — Command Prompt (cmd.exe), from the same folder
Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Installed) — works in both PowerShell and cmd.exe
"%LOCALAPPDATA%\Programs\Arroxy\Arroxy.exe" --disable-gpu
# macOS
/Applications/Arroxy.app/Contents/MacOS/Arroxy --disable-gpu
# Linux (AppImage)
./Arroxy-linux-x64.AppImage --disable-gpu
```
If that works, the GPU/driver is the cause. Make the change permanent (next step).
**3. Persist the flag via `argv.json`.** Create the file at:
| Platform | Path |
| -------- | ------------------------------------------------ |
| Windows | `%APPDATA%\Arroxy\argv.json` |
| macOS | `~/Library/Application Support/Arroxy/argv.json` |
| Linux | `~/.config/Arroxy/argv.json` |
With contents:
```json
{ "disable-hardware-acceleration": true }
```
Arroxy reads this before opening any window, so it works even when the window never appeared.
**4. Other flags worth trying** (combine if needed): `--disable-software-rasterizer`, `--disable-gpu-sandbox`, `--in-process-gpu`.
**5. Stale window position.** If the window may be opening off-screen (multi-monitor change since last run), delete `\window-state.json` and relaunch.
**6. Still stuck?** Open an issue with your OS version and any output from running with `--enable-logging --v=1`. If the app window does open, attach the file from **Settings → Save diagnostics file**: it holds both logs and your app details, with your user folder name removed. Otherwise attach `main.log`.
---
## Kullanım şartları
Arroxy yalnızca kişisel, özel kullanım için bir araçtır. İndirmelerinin YouTube [Hizmet Şartları](https://www.youtube.com/t/terms) ve bulunduğun yargı alanındaki telif hakkı yasalarına uygun olduğundan yalnızca sen sorumlusun. Kullanma hakkına sahip olmadığın içerikleri indirmek, çoğaltmak veya dağıtmak için Arroxy'yi kullanma. Geliştiriciler kötüye kullanımdan sorumlu değildir.
## Star History