# Arroxy — Kostenloser Open-Source YouTube (+ 2000 Seiten) Downloader für Windows, macOS & Linux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Sprache:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · **Deutsch** · [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.tr.md) · [አማርኛ](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://orionus.dev/arroxy/)   
Lade Videos, Shorts, Musik, Kanäle, Podcasts oder Audiotracks von **YouTube und 2000+ unterstützten Seiten** herunter — bis zu 4K HDR mit 60 fps, oder als MP3 / AAC / Opus. Läuft lokal auf Windows, macOS und Linux. **Keine Werbung, kein Bloat, kein Upselling.**
[**↓ Neueste Version herunterladen**](#install) · [**Webseite**](https://orionus.dev/arroxy/) · [Windows-Erststart](#windows-first-launch) · [macOS-Erststart](#macos-first-launch) · [Linux-Erststart](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Wenn Arroxy dir Zeit spart, hilft ein ⭐ anderen, es zu finden.
> **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-10-11._
> 🌐 Dies ist eine KI-gestützte Übersetzung. Die [englische README](README.md) ist die maßgebliche Quelle. Fehler entdeckt? [PRs sind willkommen](../../pulls).
---
## Inhalt
- [Installieren und erster Start](#install)
- [Windows-Erststart](#windows-first-launch)
- [macOS-Erststart](#macos-first-launch)
- [Warum du möglicherweise eine Warnung siehst](#why-warning)
- [Linux-Erststart](#linux-first-launch)
- [Download verifizieren (SHA256)](#verify)
- [Warum Arroxy](#why)
- [Funktionen](#features)
- [Datenschutz](#privacy)
- [Häufig gestellte Fragen](#faq)
- [Roadmap](#roadmap)
- [Arroxy unterstützen](#support)
- [Gebaut mit](#tech)
---
## Installieren und erster Start
**Windows**
```bash
winget install AntonioOrionus.Arroxy
```
**macOS**
```bash
brew install --cask antonio-orionus/arroxy/arroxy
```
**Linux**
AppImage:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh
```
Flatpak:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh -s -- --flatpak
```
Builds gibt es nur für x86_64. Kein `curl`? Ersetze `curl -fsSL` durch `wget -qO-`.
| Plattform | Format |
| --- | --- |
| 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) |
[**Neuesten Release holen →**](https://github.com/antonio-orionus/Arroxy/releases/latest)
### Windows-Erststart
Beim ersten Start kann **"Windows protected your PC"** oder **"Unknown publisher"** erscheinen. Das gilt sowohl für `Arroxy-win-x64-Setup.exe` als auch für `Arroxy-win-x64-Portable.exe`. Arroxy ist kostenlos und Open Source, und die Windows-Builds sind nicht mit einem kostenpflichtigen Zertifikat signiert, weshalb SmartScreen sie markiert. Das bedeutet **nicht** automatisch, dass Arroxy unsicher ist. So geht es weiter:
1. Klicke auf **More info**.
2. Klicke auf **Run anyway**.
#### Wenn Windows Defender die Datei markiert oder entfernt
Defender-Heuristiken markieren unsignierte NSIS-Installer und Electron-Portables manchmal als verdächtig. Wenn Defender `Arroxy-win-x64-Setup.exe` oder `Arroxy-win-x64-Portable.exe` in Quarantäne stellt, stelle sie aus **Windows Security → Virus & threat protection → Protection history** wieder her und füge die Arroxy-Executable als erlaubtes Element unter **Manage settings → Add or remove exclusions** hinzu. Wie bei SmartScreen ist der Auslöser die fehlende Herausgebersignatur, nicht erkannte Malware.
> Lade Arroxy nur von der offiziellen GitHub Releases-Seite herunter. Wenn du die Datei von einer anderen Website bekommen hast oder jemand sie dir geschickt hat, lösche sie und lade eine frische Kopie von der offiziellen Quelle herunter. Der Quellcode ist öffentlich, du kannst ihn also selbst prüfen oder Arroxy selbst kompilieren.
Lieber Scoop? `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### macOS-Erststart
Arroxy ist noch nicht für macOS code-signiert, daher kann Gatekeeper nach der Installation aus dem DMG den erschreckenden Dialog *"Arroxy.app is damaged and can't be opened"* anzeigen. Diese Meldung bedeutet, dass macOS eine unsignierte App unter Quarantäne gestellt hat; sie bedeutet nicht, dass die App-Dateien wirklich beschädigt sind. Auf aktuellen macOS-Versionen ist Terminal der zuverlässige Weg:
1. Ziehe `Arroxy.app` aus dem eingehängten DMG nach `/Applications`.
2. Öffne Terminal und führe diese zwei Befehle aus:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
Der erste Befehl entfernt das Quarantäne-Attribut von deiner installierten Arroxy-Kopie. Der zweite startet die App. `sudo` kann nach deinem Mac-Passwort fragen; Terminal zeigt beim Tippen keine Zeichen an.
**Apple Silicon vs Intel:** auf einem Mac der M-Serie (M1 / M2 / M3 / M4) lade das `arm64`-DMG herunter. Auf Intel-Macs lade das `x64`-DMG. Der falsche Build funktioniert auch über Rosetta, ist aber spürbar langsamer.
> macOS-Builds werden per CI auf Apple Silicon- und Intel-Runnern erstellt. Falls Probleme auftreten, bitte [ein Issue öffnen](../../issues) — Feedback von macOS-Nutzern beeinflusst aktiv den macOS-Testzyklus.
### Warum du möglicherweise eine Warnung siehst
Arroxy ist Open Source und MIT-lizenziert. Die Windows- und macOS-Builds sind **nicht code-signiert** — Apple Developer ID und Windows EV Code-Signing-Zertifikate kosten jeweils mehrere Hundert Dollar im Jahr, die ein Indie-Projekt aus eigener Tasche zahlt. Ohne diese Signaturen warnen Windows SmartScreen und macOS Gatekeeper beim ersten Start. Die Warnungen bedeuten *dein Betriebssystem erkennt den Herausgeber nicht* — sie bedeuten nicht, dass Arroxy Malware ist.
Drei Wege, Arroxy selbst zu überprüfen, in aufsteigender Genauigkeit:
- **Quellcode lesen.** Jede Zeile steht auf [GitHub](https://github.com/antonio-orionus/Arroxy) und du kannst [es aus dem Quellcode bauen](#tech).
- **SHA256 prüfen.** Vergleiche deine Datei mit der veröffentlichten [`SHA256SUMS`](../../releases/latest) — siehe [Download verifizieren](#verify) unten.
- **Drittanbieter-Scan.** Lade die Datei bei [VirusTotal](https://www.virustotal.com) hoch.
### Linux-Erststart
AppImages werden direkt ausgeführt — keine Installation nötig. Du musst die Datei nur als ausführbar markieren.
**Dateimanager:** Rechtsklick auf die `.AppImage` → **Eigenschaften** → **Berechtigungen** → **Datei als Programm ausführen erlauben** aktivieren, dann doppelklicken.
**Terminal:**
```bash
chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage
```
Falls der Start trotzdem fehlschlägt, starte es ohne Mounten — dafür ist kein FUSE-Paket nötig:
```bash
./Arroxy-linux-x64.AppImage --appimage-extract-and-run
```
**Optionale Desktop-Integration:** installiere [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) einmalig, und jede AppImage, auf die du doppelklickst, wird automatisch in deinem Launcher-Menü registriert — keine manuelle `.desktop`-Datei nötig.
**Einfaches Tarball (kein FUSE, keine Installation):**
Der `.tar.gz`-Build ist dieselbe App ohne AppImage-Hülle — entpacke sie irgendwohin und starte sie. Kein Installer und kein FUSE-Paket nötig.
```bash
tar xzf Arroxy-linux-x64.tar.gz
./Arroxy-linux-x64/arroxy
```
**Die Linux-Downloads auf der Release-Seite gibt es nur für x86_64.** Auf ARM64-Geräten (Raspberry Pi, Asahi Linux) lässt sich das Flatpak zwar installieren, scheitert aber beim Start mit `bwrap: execvp ldconfig: Exec format error`.
Download verifizieren (SHA256)
Jedes Release veröffentlicht eine `SHA256SUMS`-Datei zusammen mit den Binärdateien. Um zu prüfen, dass dein Download nicht beschädigt oder unterwegs manipuliert wurde, hashe deine Datei lokal und gleiche die Zeile in `SHA256SUMS` ab. Öffne die neueste Release-Seite → **Assets** → lade `SHA256SUMS` herunter.
**Windows (PowerShell or Command Prompt):**
```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
```
Möchtest du einen Drittanbieter-Malware-Scan? Lade die Datei bei [VirusTotal](https://www.virustotal.com) hoch. Eine Handvoll generischer Heuristik-Flags von kleineren Engines ist bei unsignierten Electron-Apps normal; weit verbreitete Erkennungen durch große Engines wären ein echter Anlass zur Sorge.
Windows: Installer vs. Portable
| | NSIS Installer | Portable `.exe` |
| ------------- | :----------------------: | :---------------------: |
| Installation erforderlich | Ja | Nein — von überall startbar |
| Auto-Updates | ✅ in der App | ❌ manueller Download |
| Startgeschwindigkeit | ✅ schneller | ⚠️ langsamer Kaltstart |
| Eintrag im Startmenü | ✅ | ❌ |
| Einfache Deinstallation | ✅ | ❌ einfach Datei löschen |
**Empfehlung:** Nimm den NSIS Installer für Auto-Updates und schnelleren Start. Nimm die portable `.exe` für eine Option ohne Installation und ohne Registry-Einträge.
---
## Warum Arroxy
Ein direkter Vergleich mit den gängigsten Alternativen:
| | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions |
| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |
| Kostenlos, keine Premium-Stufe | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| Open Source | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| Nur lokale Verarbeitung | ✅ | ✅ | ✅ | ❌ | ✅ |
| Kein Login oder Cookie-Export | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ |
| Keine Nutzungsbeschränkungen | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ |
| Plattformübergreifende Desktop-App | ✅ | ✅ | ✅ | N/A | ❌ |
| Untertitel + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ |
Arroxy ist für eine Sache gebaut: URL einfügen, saubere lokale Datei erhalten. Keine Konten, kein Upselling, keine Datensammlung.
---
## Funktionen
### Qualität & Formate
- Bis zu **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p
- **Hohe Bildrate** unverändert erhalten — 60 fps, 120 fps, HDR
- **Audio** — Audio-only als MP3, M4A/AAC, Opus oder WAV exportieren. In interaktiven Downloads die nativen Surround-/Dolby-Spuren der Quelle (AC-3, E-AC-3, 5.1, DRC) auswählen, sofern verfügbar, oder einen globalen Standard **Surround / Dolby bevorzugen** setzen
- Schnell-Presets: *Beste Qualität* · *Ausgewogen* · *Kleine Datei*
### Datenschutz & Kontrolle
- 100 % lokale Verarbeitung — Downloads gehen direkt von YouTube auf deine Festplatte
- Kein Login, keine Cookies, kein verknüpftes Google-Konto
- Dateien direkt in den von dir gewählten Ordner gespeichert
### Workflow
- **Globaler Download-Hotkey** — kopiere einen Link in einer beliebigen App und drücke `Ctrl+Shift+D` (`Cmd+Shift+D` unter macOS); Arroxy stellt ihn mit deinem aktiven Profil in die Warteschlange, ohne das Fenster zu öffnen, und eine Benachrichtigung bestätigt es. Standardmäßig aktiv, frei belegbar
- **Flexible Startmodi** — wähle einen geführten Einzel-Download, eine Playlist-/Kanal-Auswahl, Bulk-URL-Eingabe oder Quick Download mit gespeicherten Standardwerten
- **Zentrale Download-Warteschlange** — jeder Einzel-, Playlist-, Bulk- oder Quick-Job landet an einem Ort für Fortschritt, Pausieren, Fortsetzen, Abbrechen, Wiederholen und Priorität
- **Zwischenablage-Überwachung** — kopiere einen YouTube-Link und Arroxy füllt die URL automatisch aus, wenn du die App wieder fokussierst (in den erweiterten Einstellungen umschaltbar)
- **URLs automatisch bereinigen** — entfernt Tracking-Parameter (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) und löst `youtube.com/redirect`-Links auf
- **Tray-Modus** — das Schließen des Fensters lässt Downloads im Hintergrund weiterlaufen
- **30 Sprachen** – erkennt automatisch das Systemgebietsschema und kann jederzeit umgeschaltet werden
- **Playlist-Sync** — scannt eine Playlist erneut gegen einen lokalen Ordner, um bereits heruntergeladene Videos zu überspringen; erzeugt eine `.m3u`-Playlistdatei, die nach jedem Video aktualisiert wird
- **Geschwindigkeits- und Pacing-Kontrollen** — begrenze die Download-Bandbreite, lege fest, wie viele Teile eines Videos gleichzeitig geladen werden, und füge Anfragepausen mit Presets hinzu (*Aus · Ausgewogen · Vorsichtig · Benutzerdefiniert*)
- **Dateinamenvorlagen** — benenne Downloads nach deinen Regeln mit `{title}`, `{uploader}`, `{id}`, `{date}`, `{resolution}` und `{playlist_index}`, global oder pro Download-Profil
- **Gleichzeitige Downloads und automatische Wiederholung** — wähle, wie viele Einträge der Warteschlange gleichzeitig laufen, und lass Arroxy einen Download nach einem Netzwerk- oder Serverproblem erneut versuchen, mit längerer Wartezeit vor jedem Versuch
- **Profile pro Playlist-Eintrag** — weisen Sie jedem Video in einer Playlist ein eigenes Download-Profil zu statt einer Einstellung für die ganze Liste, sodass ein Durchlauf manche in voller Qualität archivieren und den Rest als MP3 holen kann
### Untertitel & Nachbearbeitung
- **Untertitel** in SRT, VTT oder ASS — manuell oder automatisch generiert, in jeder verfügbaren Sprache
- Neben dem Video speichern, in `.mkv` einbetten oder in einem `Subtitles/`-Unterordner organisieren
- **Nur-Untertitel-Stapel** — eine Liste von URLs einfügen oder eine Playlist öffnen, Untertitel wählen und für jedes Video nur die Untertiteldateien erhalten
- **SponsorBlock** — Sponsoren, Intros, Outros, Eigenwerbung überspringen oder als Kapitel markieren
- **Eingebettete Metadaten** — Titel, Upload-Datum, Kanal, Beschreibung, Thumbnail und Kapitelmarkierungen in die Datei geschrieben
### YouTube + 2000 Seiten
- **YouTube, vollständig** — Videos, Shorts, Kanäle, Playlists, YouTube Music und Podcasts werden als erstklassige Quellen behandelt
- **2000+ weitere Seiten** via yt-dlp — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org und viele mehr
- **Nur Audio und Untertitel** funktionieren auf jeder unterstützten Seite, nicht nur auf YouTube
- Ändert sich eine Seite, liefert yt-dlp wöchentlich Fixes und Arroxy aktualisiert das Binary beim Start automatisch
Globaler Download-Hotkey Link irgendwo kopieren, einmal drücken — er landet in der Warteschlange und der Download startet
Profile pro Playlist-Eintrag Jedem Video ein eigenes Profil geben – manche in 4K archivieren, den Rest als MP3 holen
Quick-Download-Startseite URL einfügen und sofort mit deinem aktiven Profil herunterladen
Wiederverwendbare Download-Profile Format, Qualität und Ausgabe als Voreinstellung speichern – pro Download wiederverwenden
Mehrsprachige Audiospuren Genau die Audiosprache wählen, die ein Video mitbringt
Surround-/Dolby-Audio 5.1- und Dolby-Spuren erkannt und erhalten
Massen-URL-Modus Liste einfügen, automatisch entdoppeln, alle auf einmal einreihen
Paralleler Download-Verlauf Mehrere Downloads gleichzeitig mit Live-Fortschritt
---
## Datenschutz
Downloads werden direkt über [yt-dlp](https://github.com/yt-dlp/yt-dlp) von YouTube in den von dir gewählten Ordner geholt — nichts wird über einen Drittanbieter-Server geleitet. Verlauf, Download-Historie, URLs und Dateiinhalte bleiben auf deinem Gerät.
Arroxy sendet anonyme, aggregierte Telemetrie über [OpenPanel](https://openpanel.dev) — gerade genug, um Fehler, Abstürze, Feedback, OS und App-Versionen zu verstehen. Keine URLs, Video-Titel, Dateipfade, Kontodaten, Fingerprinting oder personenbezogenen Daten. Die ID pro Installation ist zufällig und nicht mit deiner Identität verknüpft. Du kannst das in den Einstellungen deaktivieren.
---
## Häufig gestellte Fragen
**Ist es wirklich kostenlos?**
Ja — MIT-Lizenz, keine Premium-Stufe, keine Funktionsbarrieren.
**Welche Videoqualitäten kann ich herunterladen?**
Alles, was YouTube anbietet: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p, plus nur Audio. Hochbildraten-Streams mit 60 fps und 120 fps sowie HDR-Inhalte werden unverändert übernommen.
**Kann ich nur den Audio-Track als MP3 extrahieren?**
Ja. Wähle im Formatmenü *nur Audio* und dann MP3, M4A/AAC, Opus oder WAV.
**Brauche ich ein YouTube-Konto oder Cookies?**
Standardmäßig nein — Arroxy funktioniert ohne YouTube-Konto, Login oder Cookie-Export. Optionale Cookie-Unterstützung steht in den erweiterten Einstellungen zur Verfügung (Cookies source: file or browser) für Inhalte, die eine Authentifizierung erfordern, etwa altersbeschränkte oder Mitglieder-only-Videos. Sie ist standardmäßig deaktiviert. Wenn du sie aktivierst, weist das yt-dlp-Wiki darauf hin, dass [Cookie-basierte Automatisierung ein Google-Konto markieren kann](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies); ein Wegwerf-Konto ist in dem Fall die sicherere Wahl.
**Funktioniert es weiter, wenn YouTube etwas ändert?**
yt-dlp wird beim Start automatisch aktualisiert, und Arroxy liefert zügig Fixes, sobald YouTube etwas ändert. Falls du doch einmal auf ein Problem stößt, steht in den erweiterten Einstellungen optionale Cookie-Unterstützung als Fallback bereit.
**In welchen Sprachen ist Arroxy verfügbar?**
30 Sprachen sind sofort verfügbar: 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 erkennt beim ersten Start automatisch die Sprache deines Betriebssystems, und du kannst jederzeit über die Sprachauswahl in der Symbolleiste wechseln. Runtime-Locale-JSON liegt in src/shared/i18n/locales/, die PO-Kataloge für Übersetzer liegen in i18n/locales/ — öffne einen PR auf GitHub, um beizutragen.
**Muss ich etwas zusätzlich installieren?**
Nein. yt-dlp wird beim ersten Start automatisch heruntergeladen und auf deinem Rechner gecacht; ffmpeg und ffprobe werden mit der App geliefert. Danach ist keine weitere Einrichtung nötig.
**Kann ich Playlists oder ganze Kanäle herunterladen?**
Ja — beides. Füge eine Playlist-URL oder Kanal-URL ein (z. B. `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); wähle, wie viele Einträge gescannt werden sollen, und stelle dann die ganze Liste in die Warteschlange oder wähle einzelne Videos aus. Datumsfilter kommen bald.
**macOS sagt „die App ist beschädigt" — was tun?**
Das ist macOS Gatekeeper, der eine unsignierte App blockiert — kein echter Schaden. Siehe [macOS first launch](#macos-first-launch) für die Terminal-Befehle, die die Quarantäne entfernen und Arroxy starten.
**Ist das Herunterladen von YouTube-Videos legal?**
Für den persönlichen, privaten Gebrauch ist es in den meisten Rechtsordnungen allgemein akzeptiert. Du bist selbst dafür verantwortlich, die [Nutzungsbedingungen](https://www.youtube.com/t/terms) von YouTube und die Urheberrechtsgesetze deines Landes einzuhalten.
---
## Roadmap
Weiter geplant — grob nach Priorität sortiert:
| Funktion | Beschreibung |
| ---------------- | ---------------- |
| **Playlist- & Kanal-Filter** | Datumsfilter beim Einlesen einer Playlist oder eines Kanals |
| **YouTube-Audiospur-Präferenzen** | App-weite bevorzugte Sprachspur festlegen, mit Überschreibungen pro Profil, wenn YouTube mehrere Audiospuren anbietet |
| **Browser-Anmeldung in der App** | Browserfenster in Arroxy öffnen, damit du dich anmelden und Website-Cookies nutzen kannst, ohne sie manuell zu exportieren |
| **Video-Download mit einem Klick** | Einen Video-Download mit deinem aktiven Profil per Klick aus einer erkannten oder eingefügten URL starten |
| **Stärkere Wiederaufnahme nach Fehlern** | Ein neuer Retry-Pfad für Downloads, die durch unzuverlässige oder problematische Internetverbindungen unterbrochen werden |
| **Vollwertiger Download-Manager-Drawer** | Den Queue-Drawer zu einem volleren Manager ausbauen, inklusive Zielordner-Wechsel für eingereihte Elemente |
| **Geplante Downloads** | Warteschlange zu einer bestimmten Zeit starten (Nacht-Runs) |
| **Clip-Trimming** | Nur ein Segment per Start-/Endzeit herunterladen |
| **AUR-Paket** | Installation unter Arch Linux und Omarchy mit `yay -S arroxy-bin` |
Eine Funktion im Sinn? [Anfrage öffnen](../../issues) — Community-Input bestimmt die Priorität.
---
## Arroxy unterstützen
Arroxy ist kostenlos und MIT-lizenziert — keine Werbung, keine Bezahlversion. Wenn es dir Zeit spart, kannst du die Entwicklung mit Bitcoin oder Tron unterstützen: Die Adressen stehen in [DONATE.md](DONATE.md), der einzigen offiziellen Quelle dafür. Arroxy schickt dir niemals eine Adresse per E-Mail oder Direktnachricht. Ein Stern für das Repo, Fehlerberichte und bessere Übersetzungen helfen genauso viel.
---
## Gebaut mit
Stack
- **Electron** — plattformübergreifende Desktop-Shell
- **React 19** + **TypeScript** — UI
- **Tailwind CSS v4** — Styling
- **Zustand** — State Management
- **yt-dlp** + **ffmpeg** — Download- und Mux-Engine (yt-dlp wird zur Laufzeit geholt; ffmpeg/ffprobe sind beim Build gebündelt)
- **Vite** + **electron-vite** — Build-Tooling
- **Vitest** + **Playwright** — Unit- und End-to-End-Tests
Aus dem Quellcode bauen
### Voraussetzungen — alle Plattformen
| Tool | Version | Install |
| ------- | ------- | ------- |
| Git | any | [git-scm.com](https://git-scm.com) |
| Node.js | 24.16.0 | `mise install` oder `.node-version` |
| Bun | 1.2.23 | `mise install` oder `package.json` `packageManager` |
Empfohlen: `mise` installieren und dann im Checkout `mise install` ausführen. Ohne mise Node.js aus `.node-version` und Bun aus `package.json` manuell aktivieren, bevor `bun run bootstrap` läuft.
### Windows
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
Visual Studio Build Tools und Python können für native Rebuilds erforderlich sein.
### macOS
```bash
brew install mise
xcode-select --install
```
Führe nach dem Klonen `mise trust && mise install` im Checkout aus. Wenn deine Shell bereits `fnm`, `nvm` oder ein Homebrew-Bun nutzt, aktiviere mise in `~/.zshrc`, damit Arroxy Node.js 24.16.0 und Bun 1.2.23 verwendet:
```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
# Build- und Electron-Runtime-Abhängigkeiten
sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64
# E2E tests only (Electron needs a display)
sudo apt install -y xvfb
```
### Klonen & starten
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # empfohlen; überspringen, wenn die gepinnten Tools manuell aktiv sind
bun run bootstrap
bun run doctor
bun run dev # Electron-App gegen den Vite-Renderer
```
### Distributables bauen
```bash
bun run build # typecheck + compile
bun run dist # für aktuelles OS paketieren
bun run dist:win # Windows-Ziele auf unterstütztem Host paketieren
```
> `bun run bootstrap` installiert Abhängigkeiten, baut Electron-App-Abhängigkeiten neu, prüft Electron, bereitet eingebettete ffmpeg/ffprobe für die Entwicklung vor und installiert Playwright Chromium. yt-dlp wird zur Laufzeit im App-Datenordner verwaltet; ffmpeg und ffprobe sind in jedem Arroxy-Release enthalten.
---
## 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`.
---
## Nutzungsbedingungen
Arroxy ist ein Werkzeug ausschließlich für den persönlichen, privaten Gebrauch. Du bist allein dafür verantwortlich, dass deine Downloads den [YouTube-AGB](https://www.youtube.com/t/terms) und dem Urheberrecht deines Landes entsprechen. Verwende Arroxy nicht, um Inhalte herunterzuladen, zu vervielfältigen oder zu verbreiten, an denen du keine Rechte hast. Die Entwickler haften nicht für Missbrauch.
## Star History