Nembo ya Arroxy # Arroxy — Kipakuzi Bure cha Chanzo Wazi cha YouTube (+ Tovuti 2000) kwa Windows, macOS na Linux **4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites** **Soma kwa:** [Afaan Oromoo](README.om.md) · [Deutsch](README.de.md) · [English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · **Kiswahili** · [O'zbekcha](README.uz.md) · [Tiếng Việt](README.vi.md) · [አማርኛ](README.am.md) · [العربية](README.ar.md) · [اردو](README.ur.md) · [پښتو](README.ps.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · [Українська](README.uk.md) · [中文](README.zh.md) · [日本語](README.ja.md) [![Toleo](https://img.shields.io/github/v/release/antonio-orionus/Arroxy?label=Release&color=blueviolet)](https://github.com/antonio-orionus/Arroxy/releases/latest) [![Ujenzi](https://img.shields.io/github/actions/workflow/status/antonio-orionus/Arroxy/release.yml?label=Build)](https://github.com/antonio-orionus/Arroxy/actions/workflows/release.yml) [![Tovuti](https://img.shields.io/badge/website-arroxy.orionus.dev-blueviolet)](https://arroxy.orionus.dev/) ![Leseni](https://img.shields.io/badge/license-MIT-green) ![Majukwaa](https://img.shields.io/badge/platform-cross--platform-1f2937?logo=github&logoColor=white) ![Lugha](https://img.shields.io/badge/i18n-21_languages-blue) Pakua video, Shorts, muziki, vituo, podikasti, au nyimbo za sauti kutoka **YouTube na tovuti 2000+ zinazotumika** — hadi 4K HDR kwa fps 60, au kama MP3 / AAC / Opus. Inafanya kazi mahali hapo kwenye Windows, macOS, na Linux. **Hakuna matangazo, hakuna mzigo wa ziada, hakuna mauzo ya ziada.** [**↓ Pakua Toleo la Hivi Karibuni**](#install)  ·  [**Tovuti**](https://arroxy.orionus.dev/)  ·  [Windows](#install) · [macOS](#install) · [Linux](#install) [![Jiunge na jumuiya ya Discord](https://img.shields.io/badge/Jiunge%20na%20jumuiya%20ya%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/ueGvXwQH8y) Demo ya Arroxy Arroxy — Quick Download home Ikiwa Arroxy inakuokoa muda, ⭐ inasaidia wengine kuipata.
> **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-06-17._ --- ## Yaliyomo - [Pakua](#install) - [Kwa Nini Arroxy](#why) - [Vipengele](#features) - [Faragha](#privacy) - [Maswali Yanayoulizwa Mara kwa Mara](#faq) - [Ramani ya Barabara](#roadmap) - [Imejengwa na](#tech) --- ## Pakua | Jukwaa | Fomati | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Windows | [![Windows Setup](https://img.shields.io/badge/Windows-Setup-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Setup.exe) [![Windows Portable](https://img.shields.io/badge/Windows-Portable-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Portable.exe) | | macOS | [![macOS Apple Silicon](https://img.shields.io/badge/macOS-Apple%20Silicon-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-arm64.dmg) [![macOS Intel](https://img.shields.io/badge/macOS-Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-x64.dmg) | | Linux | [![Linux AppImage](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.AppImage) [![Linux Flatpak](https://img.shields.io/badge/Linux-Flatpak-4A90D9?style=for-the-badge&logo=flathub&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.flatpak) [![Linux tar.gz](https://img.shields.io/badge/Linux-tar.gz-6B7280?style=for-the-badge&logo=linux&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.tar.gz) | | Verify | [![SHA256 Checksums](https://img.shields.io/badge/SHA256-Checksums-4B5563?style=for-the-badge&logo=github&logoColor=white)](https://github.com/antonio-orionus/Arroxy/releases/latest/download/SHA256SUMS) | [**Pata toleo la hivi karibuni →**](https://github.com/antonio-orionus/Arroxy/releases/latest) ### Kwa nini unaweza kuona onyo Arroxy ni chanzo wazi na ina leseni ya MIT. Ujenzi wa Windows na macOS **haujasainiwa kwa nambari** — cheti cha Apple Developer ID na Windows EV cha kutia saini msimbo huchangia mamia ya dola kwa mwaka, ambayo mradi wa kujitegemea hulipa mfukoni mwake. Bila saini hizo, Windows SmartScreen na macOS Gatekeeper watakuonya wakati wa uzinduzi wa kwanza. Maonyo hayo yanamaanisha *mfumo wako wa uendeshaji haukuitambua kampuni inayotoa programu* — hayamaanishi kwamba Arroxy ni programu hasidi. Njia tatu za kuthibitisha Arroxy mwenyewe, kwa uthabiti unaozidi: - **Soma msimbo wa chanzo.** Kila mstari uko kwenye [GitHub](https://github.com/antonio-orionus/Arroxy) na unaweza [kuijenga kutoka chanzo](#tech). - **Angalia SHA256.** Linganisha faili yako na [`SHA256SUMS`](../../releases/latest) iliyochapishwa — tazama [Thibitisha upakuaji wako](#verify) hapa chini. - **Fanya ukaguzi wa tatu.** Pakia faili kwenye [VirusTotal](https://www.virustotal.com). ### Uzinduzi wa kwanza wa Windows Wakati wa uzinduzi wa kwanza unaweza kuona **"Windows protected your PC"** au **"Unknown publisher."** Hii inatumika kwa `Arroxy-win-x64-Setup.exe` na `Arroxy-win-x64-Portable.exe`. Arroxy ni bure na chanzo wazi, na ujenzi wa Windows haujasainiwa kwa cheti cha malipo, ndiyo maana SmartScreen huipiga bendera. Hii **haimaanishi** kiotomatiki kwamba Arroxy si salama. Ili kuendelea:
SmartScreen SmartScreen dialog after expanding More info, showing the
1. Bonyeza **More info**. 2. Bonyeza **Run anyway**. #### Ikiwa Windows Defender inaweka bendera au kuondoa faili Heuristics za Defender wakati mwingine huweka bendera kwenye visanidi visivyosainiwa vya NSIS na portable za Electron kama zinazoshukiwa. Ikiwa Defender inaweka karantini `Arroxy-win-x64-Setup.exe` au `Arroxy-win-x64-Portable.exe`, irudishe kutoka **Windows Security → Virus & threat protection → Protection history**, kisha ongeza faili inayoweza kutekelezwa ya Arroxy kama kipengele kinachoruhusiwa chini ya **Manage settings → Add or remove exclusions**. Kama ilivyo na SmartScreen, kisababishi ni saini ya mchapishaji inayokosekana, si programu hasidi iliyogunduliwa. > Pakua Arroxy tu kutoka ukurasa rasmi wa GitHub Releases. Ukipata faili kutoka tovuti nyingine au mtu akikutumia, ifute na upakue nakala mpya kutoka chanzo rasmi. Msimbo wa chanzo ni wa umma, hivyo unaweza kuukagua au kuijenga Arroxy mwenyewe ukitaka. ### Uzinduzi wa kwanza wa macOS Arroxy bado haijasainiwa kwa nambari kwa macOS, kwa hivyo Gatekeeper itazuia uzinduzi wa kwanza. Njia halisi ya kuiruhusu inategemea toleo lako la macOS — Sequoia 15 ilifunga njia ya zamani ya kukwepa kwa kubonyeza kulia → Open. #### macOS Sequoia 15 na baadaye (ya sasa) Kwenye Sequoia 15 na toleo jipya zaidi, kubonyeza kulia → Open haizuii tena Gatekeeper kwa programu nyingi zilizowekwa karantini. Tumia paneli ya Mipangilio ya Mfumo badala yake: 1. Buruta `Arroxy.app` kutoka kwenye DMG iliyopachikwa hadi `/Applications`. 2. Bonyeza mara mbili Arroxy. Sanduku la mazungumzo la kuzuia linaonekana — bonyeza **Done** (usibonyeze *Move to Trash*). 3. Fungua **System Settings → Privacy & Security** na tembeza hadi sehemu ya **Security**. Utaona *"Arroxy was blocked to protect your Mac"* (au ujumbe unaofanana sana). 4. Bonyeza **Open Anyway**, thibitisha kwa nenosiri lako au Touch ID, kisha uzindue tena Arroxy kutoka `/Applications`. #### macOS Sonoma 14 na mapema zaidi 1. Buruta `Arroxy.app` kutoka kwenye DMG iliyopachikwa hadi `/Applications`. 2. Bonyeza kulia (au Control-bonyeza) `Arroxy.app` katika `/Applications` na uchague **Open**. 3. Sanduku la onyo sasa lina kitufe cha **Open** — bonyeza na uthibitishe. Arroxy inafunguka kawaida na onyo halitatokea tena. #### "App is damaged" au kizuizi cha Gatekeeper kinachoendelea — suluhisho la Terminal Ikiwa macOS inasema *"Arroxy is damaged and can't be opened"*, au hakuna hatua zilizo hapo juu zinazoondoa kizuizi, sifa ya karantini kwenye DMG ndiyo sababu (vivinjari vingine na tabia ya translocation ya macOS yenyewe huiweka). Iondoe kutoka kwa programu iliyosanikishwa: ```bash xattr -dr com.apple.quarantine /Applications/Arroxy.app ``` **Apple Silicon vs Intel:** kwenye Mac ya mfululizo wa M (M1 / M2 / M3 / M4), pakua DMG ya `arm64`. Kwenye Mac za Intel, pakua DMG ya `x64`. Kuendesha build isiyo sahihi bado kunafanya kazi kupitia Rosetta lakini ni polepole zaidi kwa kiasi kinachoonekana. > Ujenzi wa macOS hufanywa kupitia CI kwenye vichakataji vya Apple Silicon na Intel. Ukipata matatizo, tafadhali [fungua tatizo](../../issues) — maoni kutoka kwa watumiaji wa macOS yanaathiri kikamilifu mzunguko wa majaribio ya macOS. ### Uzinduzi wa kwanza wa Linux AppImages zinaendesha moja kwa moja — hakuna usanidi. Unahitaji tu kuweka faili kama inayoweza kutekelezwa. **Kidhibiti cha faili:** bonyeza kulia `.AppImage` → **Properties** → **Permissions** → wezesha **Allow executing file as program**, kisha bonyeza mara mbili. **Terminal:** ```bash chmod +x Arroxy-linux-x64.AppImage ./Arroxy-linux-x64.AppImage ``` Ikiwa uzinduzi bado unashindwa, huenda FUSE haipo: ```bash # Ubuntu / Debian sudo apt install -y libfuse2 # Fedora sudo dnf install -y fuse-libs # Arch sudo pacman -S fuse2 ``` **Uunganishaji wa hiari wa desktop:** sakinisha [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) mara moja, na AppImage yoyote unayobonyeza mara mbili itasajiliwa kiotomatiki kwenye menyu yako ya uzinduzi — hakuna faili ya `.desktop` ya mkono inayohitajika. **Flatpak (mbadala wenye sanduku):** pakua `Arroxy-*.flatpak` kutoka ukurasa huo huo wa toleo. ```bash flatpak install --user Arroxy-linux-x64.flatpak flatpak run io.github.antonio_orionus.Arroxy ```
Thibitisha upakuaji wako (SHA256) Kila toleo linachapisha faili ya `SHA256SUMS` pamoja na faili za binary. Ili kuangalia kwamba upakuaji wako haukuharibiwa au kubadilishwa wakati wa usafirishaji, hesabu hash ya faili yako mahali hapo na ulinganishe mstari katika `SHA256SUMS`. Fungua ukurasa wa toleo la hivi karibuni → **Assets** → pakua `SHA256SUMS`. **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 ``` Unataka ukaguzi wa programu hasidi wa mtu wa tatu? Pakia faili kwenye [VirusTotal](https://www.virustotal.com). Bendera chache za heuristic za jumla kutoka kwa injini ndogo ni za kawaida kwa programu za Electron zisizosainiwa; ugunduzi ulioenea kutoka kwa injini kubwa ungekuwa wasiwasi wa kweli.
Sanidi kupitia meneja wa pakiti Tayari unatumia meneja wa pakiti? Unaweza kuruka njia ya upakuaji wa mkono. | Njia | Amri | | ------------------ | ------------------------------------------------------------------------------------------------- | | Winget | `winget install AntonioOrionus.Arroxy` | | Scoop | `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy` | | Homebrew | `brew tap antonio-orionus/arroxy && brew install --cask arroxy` | | Flatpak | `flatpak install --user Arroxy-linux-x64.flatpak` |
Windows: Kisanidi dhidi ya Inayobebeka | | Kisanidi cha NSIS | Inayobebeka `.exe` | | ------------- | :----------------------: | :---------------------: | | Usanidi unahitajika | Ndiyo | Hapana — endesha kutoka mahali popote | | Masasisho ya kiotomatiki | ✅ ndani ya programu | ❌ upakuaji wa mkono | | Kasi ya uzinduzi | ✅ ya haraka zaidi | ⚠️ mwanzo wa polepole baridi | | Inaongeza kwenye Menyu ya Kuanza | ✅ | ❌ | | Kuondoa kwa urahisi | ✅ | ❌ futa faili | **Pendekezo:** tumia kisanidi cha NSIS kwa masasisho ya kiotomatiki na uzinduzi wa haraka. Tumia `.exe` inayobebeka kwa chaguo lisilo na usanidi na bila usajili.
--- ## Kwa Nini Arroxy Ulinganisho wa pamoja na mbadala za kawaida zaidi: | | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions | | ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: | | Bure, hakuna ngazi ya malipo | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ | | Chanzo wazi | ✅ | ❌ | ❌ | ❌ | ⚠️ | | Usindikaji wa mahali hapo tu | ✅ | ✅ | ✅ | ❌ | ✅ | | Hakuna kuingia au kuhamisha vidakuzi | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ | | Hakuna vikwazo vya matumizi | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ | | Programu ya mezani inayofanya kazi kwenye mifumo yote | ✅ | ✅ | ✅ | N/A | ❌ | | Manukuu + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ | Arroxy imejengwa kwa jambo moja: bandika URL, pata faili safi la mahali hapo. Hakuna akaunti, hakuna mauzo ya ziada, hakuna ukusanyaji wa data. --- ## Vipengele ### Ubora na fomati - Hadi **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p - **Kiwango cha juu cha fremu** kimehifadhiwa kama kilivyo — fps 60, fps 120, HDR - **Sauti** — hamisha sauti pekee kama MP3, M4A/AAC, Opus au WAV. Katika upakuaji wa mwingiliano, chagua nyimbo asili za surround/Dolby za chanzo (AC-3, E-AC-3, 5.1, DRC) zinapopatikana, au weka chaguo-msingi la jumla **Pendelea surround / Dolby** - Maandiko ya haraka: *Ubora bora* · *Usawa* · *Faili ndogo* ### Faragha na udhibiti - Usindikaji wa mahali hapo 100% — maudhui yanashuka moja kwa moja kutoka YouTube hadi kwenye diski yako - Hakuna kuingia, hakuna vidakuzi, hakuna akaunti ya Google iliyounganishwa - Faili zimehifadhiwa moja kwa moja kwenye folda unayochagua ### Mtiririko wa kazi - **Njia rahisi za kuanza** — chagua upakuaji mmoja unaoongozwa, kichagua playlist/channel, kubandika URL nyingi, au Quick Download kwa mipangilio chaguomsingi iliyohifadhiwa - **Foleni kuu ya upakuaji** — kazi ya single, playlist, bulk, au quick yote huingia sehemu moja kwa maendeleo, kusitisha, kuendelea, kughairi, kujaribu tena, na udhibiti wa kipaumbele - **Ufuatiliaji wa ubao wa kunakili** — nakili kiungo cha YouTube na Arroxy itajaza URL kiotomatiki ukirejesha umakini kwenye programu (washa/zima katika mipangilio ya Kina) - **Usafi wa URL kiotomatiki** — huondoa vigezo vya ufuatiliaji (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) na kufungua viungo vya `youtube.com/redirect` - **Hali ya tray** — kufunga dirisha kunaacha maudhui kuendelea kupakuliwa nyuma ya skrini - **Lugha 21** — hugundua kiotomatiki lugha ya mfumo, inaweza kubadilishwa wakati wowote - **Usawazishaji wa orodha ya kucheza** — hukagua tena orodha ya kucheza dhidi ya folda ya ndani ili kuruka video zilizopakuliwa tayari; hutengeneza faili ya orodha ya kucheza `.m3u` inayosasishwa kila video inapopakuliwa - **Udhibiti wa kasi na pacing** — weka kikomo cha bandwidth ya upakuaji, ongeza ucheleweshaji wa maombi, na rekebisha fragment threads kwa presets (*Off · Balanced · Careful · Custom*) ### Manukuu na usindikaji wa baada ya kupakua - **Manukuu** katika SRT, VTT, au ASS — ya mkono au yaliyozalishwa kiotomatiki, katika lugha yoyote inayopatikana - Hifadhi karibu na video, ingiza ndani ya `.mkv`, au panga katika folda ndogo ya `Subtitles/` - **SponsorBlock** — ruka au weka alama za sehemu kwenye wadhamini, utangulizi, mwisho, matangazo binafsi - **Metadata iliyowekwa** — kichwa, tarehe ya kupakia, chaneli, maelezo, picha ndogo, na alama za sura zimeandikwa ndani ya faili ### YouTube + Tovuti 2000 - **YouTube kamili** — Video, Shorts, Vituo, Orodha za Kucheza, YouTube Music na Podikasti zinashughulikiwa kama vyanzo vya daraja la kwanza - **Tovuti 2000+ nyingine** kupitia yt-dlp — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org na nyingi zaidi - **Sauti pekee na manukuu** yanafanya kazi kwenye kila tovuti inayoungwa mkono, si YouTube peke yake - Tovuti ikibadilika, yt-dlp hutoa marekebisho kila wiki na Arroxy husasisha binary kiotomatiki wakati wa uzinduzi
Arroxy — Quick Download home
Ukurasa wa Upakuaji wa haraka
Bandika URL na uipakue papo hapo kwa wasifu wako amilifu		 Arroxy — Download profiles
Wasifu wa upakuaji unaoweza kutumika tena
Hifadhi muundo, ubora na matokeo kama mipangilio — tumia tena kwa kila upakuaji
Arroxy — Multi-language audio
Nyimbo za sauti za lugha nyingi
Chagua lugha kamili ya sauti inayokuja na video		 Arroxy — Surround / Dolby audio
Sauti ya Surround / Dolby
Nyimbo za 5.1 na Dolby zinatambuliwa na kuhifadhiwa
Arroxy — Bulk URL mode
Hali ya URL nyingi
Bandika orodha, ondoa nakala kiotomatiki, panga zote kwa pamoja		 Arroxy — Parallel download queue
Foleni ya upakuaji sambamba
Upakuaji kadhaa kwa wakati mmoja na maendeleo ya moja kwa moja
--- ## Faragha Maudhui hupakuliwa moja kwa moja kupitia [yt-dlp](https://github.com/yt-dlp/yt-dlp) kutoka YouTube hadi kwenye folda unayochagua — hakuna kitu kinachopita kwenye seva ya mtu wa tatu. Historia ya kutazama, historia ya kupakua, URL, na maudhui ya faili yanabaki kwenye kifaa chako. Arroxy hutuma telemetry isiyo na jina na ya jumla kupitia [OpenPanel](https://openpanel.dev) — ya kutosha kuelewa uzinduzi, OS, matoleo ya programu na ajali. Hakuna URLs, vichwa vya video, njia za faili, taarifa za akaunti, fingerprinting au data binafsi. Kitambulisho cha kila usakinishaji ni cha nasibu na hakihusiani na utambulisho wako. Unaweza kujiondoa katika Mipangilio. --- ## Maswali Yanayoulizwa Mara kwa Mara **Je, ni bure kweli kweli?** Ndiyo — leseni ya MIT, hakuna ngazi ya malipo, hakuna kizuizi cha vipengele. **Ninaweza kupakua ubora gani wa video?** Chochote YouTube kinatoa: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p, pamoja na sauti pekee. Mtiririko wa fps 60, fps 120, na HDR huhifadhiwa kama ulivyo. **Je, ninaweza kutoa sauti pekee kama MP3?** Ndiyo. Chagua *sauti pekee* kwenye menyu ya fomati kisha uchague MP3, M4A/AAC, Opus au WAV. **Je, ninahitaji akaunti ya YouTube au vidakuzi?** Kwa chaguomsingi, hapana — Arroxy hufanya kazi bila akaunti ya YouTube, kuingia, au kuhamisha vidakuzi. Usaidizi wa hiari wa vidakuzi unapatikana katika Mipangilio ya Kina (Chanzo cha vidakuzi: faili au kivinjari) kwa maudhui yanayohitaji uthibitisho, kama vile video zenye vikwazo vya umri au za wanachama tu. Umezimwa kwa chaguomsingi. Ukiwasha, wiki ya yt-dlp inaeleza kwamba [otomatiki inayotegemea vidakuzi inaweza kuweka alama kwenye akaunti yako ya Google](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies); akaunti ya kutupa ni chaguo salama zaidi katika hali hiyo. **Je, itaendelea kufanya kazi YouTube ikibadilisha kitu?** yt-dlp husasishwa kiotomatiki wakati wa uzinduzi, na Arroxy hutuma marekebisho haraka YouTube inapobadilisha kitu. Iwapo utakutana na tatizo, usaidizi wa hiari wa vidakuzi unapatikana katika Mipangilio ya Kina kama suluhisho la akiba. **Arroxy inapatikana katika lugha zipi?** Ishirini na moja, kutoka mwanzoni: English, Español (Kihispania), Deutsch (Kijerumani), Français (Kifaransa), 日本語 (Kijapani), 中文 (Kichina), Русский (Kirusi), Українська (Kiukraini), हिन्दी (Kihindi), Afaan Oromoo, Kiswahili, O'zbekcha (Kiuzbeki), Tiếng Việt (Kivietinamu), አማርኛ (Kiamhara), العربية (Kiarabu), اردو (Kiurdu), پښتو (Kipashto), বাংলা (Kibengali), မြန်မာဘာသာ (Kiburma), Ελληνικά (Kigiriki), na Српски (Kiserbia). Arroxy hugundua lugha ya mfumo wako wa uendeshaji wakati wa uzinduzi wa kwanza na unaweza kubadili wakati wowote kutoka kichaguo cha lugha kwenye upau wa zana. JSON za locale za runtime ziko src/shared/i18n/locales/, na katalogi za PO kwa watafsiri ziko i18n/locales/ — fungua PR kwenye GitHub kuchangia. **Je, ninahitaji kusakinisha kitu kingine chochote?** Hapana. yt-dlp hupakuliwa kiotomatiki wakati wa uzinduzi wa kwanza na kuhifadhiwa kwenye kifaa chako; ffmpeg na ffprobe huja pamoja na programu. Baada ya hapo, hakuna usanidi wa ziada unaohitajika. **Je, ninaweza kupakua orodha za kucheza au vituo vyote?** Ndiyo — zote mbili. Bandika URL ya playlist au channel (mf. `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); chagua idadi ya vipengee vya kuchanganua, kisha weka orodha yote kwenye foleni au chagua video maalum. Vichujio vya tarehe vinakuja hivi karibuni. **macOS inasema "programu imeharibiwa" — nifanye nini?** Hiyo ni macOS Gatekeeper inayozuia programu isiyosainiwa, si uharibifu wa kweli. Tazama ["App is damaged" — suluhisho la Terminal](#macos-first-launch) kwa amri ya mstari mmoja ya `xattr` inayoondoa kizuizi. **Je, ni halali kupakua video za YouTube?** Kwa matumizi ya kibinafsi na ya faragha, kwa ujumla inakubaliwa katika mamlaka nyingi. Unawajibika kufuata [Masharti ya Huduma](https://www.youtube.com/t/terms) ya YouTube na sheria za haki miliki za mamlaka yako. --- ## Ramani ya Barabara Bado imepangwa — takriban kwa mpangilio wa kipaumbele: | Kipengele | Maelezo | | ---------------- | ---------------- | | **Vichujio vya orodha za kucheza na vituo** | Vichujio vya muda wa tarehe unapoorodhesha playlist au channel | | **Mapendeleo ya track za sauti za YouTube** | Weka upendeleo wa track ya lugha ya mazungumzo kwa app nzima, na override kwa kila profile YouTube inapotoa track nyingi za sauti | | **Kuingia kwa browser ndani ya app** | Fungua browser windows ndani ya Arroxy ili uingie na kutumia site cookies bila kuziexport mwenyewe | | **Upakuaji wa video kwa click moja** | Anzisha video download kwa click moja kutoka URL iliyotambuliwa au kubandikwa ukitumia active profile | | **Urejeshaji imara kwa retry** | Njia mpya ya retry kwa upakuaji uliokatizwa na miunganisho ya internet isiyotegemeka au yenye matatizo | | **Drawer kamili ya msimamizi wa upakuaji** | Kubadilisha queue drawer kuwa manager kamili zaidi, ikijumuisha kubadilisha folder za destination kwa vipengee vilivyo kwenye foleni | | **Upakuaji uliopangwa** | Anza foleni kwa wakati uliowekwa (uendeshaji wa usiku) | | **Kukata sehemu** | Pakua sehemu pekee kwa wakati wa kuanza/kumalizia | Una kipengele unachofikiria? [Fungua ombi](../../issues) — maoni ya jamii huathiri kipaumbele. --- ## Imejengwa na
Stack - **Electron** — programu ya mezani inayofanya kazi kwenye mifumo yote - **React 19** + **TypeScript** — kiolesura cha mtumiaji - **Tailwind CSS v4** — muundo wa kuonekana - **Zustand** — usimamizi wa hali - **yt-dlp** + **ffmpeg** — injini ya kupakua na kuchanganya (yt-dlp hupakuliwa wakati wa runtime; ffmpeg/ffprobe hujumuishwa wakati wa build) - **Vite** + **electron-vite** — zana za ujenzi - **Vitest** + **Playwright** — majaribio ya kitengo na ya mwisho-hadi-mwisho
Jenga kutoka chanzo ### Mahitaji ya awali — mifumo yote | Zana | Toleo | Usanidi | | ------- | ------- | ------- | | Git | yoyote | [git-scm.com](https://git-scm.com) | | Node.js | 24.16.0 | `mise install` au `.node-version` | | Bun | 1.2.23 | `mise install` au `package.json` `packageManager` | Inapendekezwa: sakinisha `mise`, kisha endesha `mise install` ndani ya checkout. Bila mise, washa Node.js kutoka `.node-version` na Bun kutoka `package.json` kabla ya `bun run bootstrap`. ### Windows ```powershell powershell -c "irm bun.sh/install.ps1 | iex" ``` Visual Studio Build Tools na Python zinaweza kuhitajika kwa rebuild za asili. ### macOS ```bash xcode-select --install curl -fsSL https://bun.sh/install | bash ``` ### Linux (Ubuntu / Debian) ```bash curl -fsSL https://bun.sh/install | bash # Utegemezi wa build na wakati wa utekelezaji wa Electron sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64 # Majaribio ya E2E tu (Electron inahitaji skrini) sudo apt install -y xvfb ``` ### Clone na uendeshe ```bash git clone https://github.com/antonio-orionus/Arroxy cd Arroxy mise install # inapendekezwa; ruka kama umewezesha zana zilizopiniwa mwenyewe bun run bootstrap bun run doctor bun run dev # programu ya Electron dhidi ya Vite renderer ``` ### Jenga faili la usambazaji ```bash bun run build # ukaguzi wa aina + mkusanyiko bun run dist # funga kwa OS ya sasa bun run dist:win # funga malengo ya Windows kwenye host inayotumika ``` > `bun run bootstrap` husakinisha utegemezi, hujenga upya utegemezi wa programu ya Electron, huthibitisha Electron, huandaa ffmpeg/ffprobe zilizopachikwa kwa maendeleo, na husakinisha Playwright Chromium. yt-dlp husimamiwa wakati wa runtime kwenye folda ya data ya programu; ffmpeg na ffprobe hujumuishwa katika kila toleo la Arroxy.
--- ## 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: OS version, the contents of `main.log`, and any output from running with `--enable-logging --v=1`. --- ## Masharti ya matumizi Arroxy ni zana ya matumizi ya kibinafsi na ya faragha tu. Unawajibika peke yako kuhakikisha maudhui unayopakua yanafuata [Masharti ya Huduma](https://www.youtube.com/t/terms) ya YouTube na sheria za haki miliki za mamlaka yako. Usitumie Arroxy kupakua, kunakili, au kusambaza maudhui ambayo huna haki ya kuyatumia. Waendelezaji hawana jukumu lolote kwa matumizi mabaya. ## Star History Star History Chart
Leseni ya MIT · Imetengenezwa kwa uangalifu na @OrionusAI