Skip to content

Latest commit

 

History

History
498 lines (336 loc) · 33.1 KB

File metadata and controls

498 lines (336 loc) · 33.1 KB
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 · Deutsch · English · Español · Français · Kiswahili · O'zbekcha · Tiếng Việt · አማርኛ · العربية · اردو · پښتو · বাংলা · हिन्दी · မြန်မာဘာသာ · Ελληνικά · Русский · Српски · Українська · 中文 · 日本語

Toleo Ujenzi Tovuti Leseni Majukwaa Lugha

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  ·  Tovuti  ·  Windows · macOS · Linux

Jiunge na jumuiya ya Discord

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-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, Scoop, Homebrew Cask, Flatpak, AppImage, and direct download.

Last updated: 2026-06-17.


Yaliyomo


Pakua

Jukwaa Fomati
Windows Windows Setup Windows Portable
macOS macOS Apple Silicon macOS Intel
Linux Linux AppImage Linux Flatpak Linux tar.gz
Verify SHA256 Checksums

Pata toleo la hivi karibuni →

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:

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:

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 — 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 .AppImagePropertiesPermissions → wezesha Allow executing file as program, kisha bonyeza mara mbili.

Terminal:

chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage

Ikiwa uzinduzi bado unashindwa, huenda FUSE haipo:

# 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 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.

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):

certutil -hashfile Arroxy-win-x64-Setup.exe SHA256

macOS (Terminal):

shasum -a 256 Arroxy-mac-arm64.dmg

Linux (Terminal):

sha256sum Arroxy-linux-x64.AppImage

Unataka ukaguzi wa programu hasidi wa mtu wa tatu? Pakia faili kwenye VirusTotal. 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 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 — 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; 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 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 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 — 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
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 -c "irm bun.sh/install.ps1 | iex"

Visual Studio Build Tools na Python zinaweza kuhitajika kwa rebuild za asili.

macOS

xcode-select --install
curl -fsSL https://bun.sh/install | bash

Linux (Ubuntu / Debian)

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

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

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:

# 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:

{ "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 <userData>\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 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