Aevum — a simple, self-contained desktop app to download videos and audio from any site: YouTube, Vimeo, Twitter/X, Dailymotion, Twitch, and ~1,800 more (anything yt-dlp supports). No installation, no dependencies: everything is bundled into a single executable (.exe on Windows, AppImage on Linux).
Free, open source, and completely ad-free — no ads, no tracking, no bundled extras. Just the download.
Aevum runs on your machine. It contacts GitHub, and only for updates. Downloading is entirely local — Aevum talks to the video sites you paste and nowhere else, and your files and history never leave your computer. The single exception: when you open Settings, it asks GitHub what the newest release is, and what the newest yt-dlp is, because a program cannot know it is out of date without asking. Those requests carry nothing about you or what you have downloaded — the same public read as opening this page in a browser. Never open Settings and it never asks. No analytics, no accounts, no telemetry, nothing reported to the developer. Details
Two ways, both on the Releases page:
Aevum-Setup.exe— installer. Installs Aevum, with optional Desktop and Start Menu shortcuts, and an uninstaller. No admin rights needed.Aevum.exe— portable. Just double-click; no install.Aevum-x86_64.AppImage— Linux. Make it executable (chmod +x) and run; optionally add it to your app menu from Settings inside the app.
Aevum opens its interface in your browser (localhost). On Windows it lives in your system tray — right-click the tray icon to open or quit. On Linux there is no tray: the app runs while its browser tab is open and quits automatically when you close the tab (an active download keeps it alive until it finishes).
Click the ⚙️ gear (next to the language picker) to open Settings. Launch at startup (Windows only) makes Aevum start with Windows and wait quietly in the tray (it does not pop the window open) — open it from the tray icon whenever you need it. On Linux the Settings panel offers Add to app menu instead, which installs Aevum as a regular menu app — it copies the AppImage into ~/.local/share/aevum/, so you can delete the downloaded file afterwards; unticking removes the copy, menu entry and icon. Shown once on first run; changeable anytime.
Aevum is not code-signed (a signing certificate costs money), so on the first run Windows SmartScreen shows a blue "Windows protected your PC" box. This is expected for small independent apps — it does not mean the app is unsafe. To run it:
- Click More info.
- Click Run anyway.
You only need to do this once.
- Open source — all the code is in this repository; you can read exactly what it does.
- Runs locally — with one exception, and here it is — downloading is entirely local: Aevum talks only to the video sites you paste, and your files never leave your machine. There are no analytics, no accounts and no telemetry, and nothing is reported to the developer. The one thing that is not local is checking for updates, because a program cannot know it is out of date without asking. From 1.2.5, opening Settings makes an HTTPS request to
api.github.comfor this repository's newest release; that is how the version line knows whether you are behind. From 1.2.6 it makes two more, for the Packages line: one for yt-dlp's newest stable and one for its newest nightly, because it offers you whichever of the two is actually ahead of what you have. Three requests, all toapi.github.com, all only when you open that panel — never at launch, never in the background — and the answers are reused for fifteen minutes. Nothing about you or about what you have downloaded goes with it: it is the same public read as opening the releases page in a browser. Never open Settings and Aevum never contacts GitHub at all. - Verify your download — each release includes
checksums.txt(SHA‑256). You can confirm the file you downloaded matches. A VirusTotal scan link is provided in the release notes.
- Any site — powered by yt-dlp, works far beyond YouTube.
- Video or audio — pick resolution (up to 4K), container (MP4/MKV/WebM, plus an editor-friendly H.264 preset), or extract audio (MP3/M4A/Opus/FLAC/WAV). Bitrate is an encoding target, not a promise about source quality; compatible streams can be copied. Original saves the available separate audio stream without re-encoding. A site with only combined video/audio can use the conversion formats instead. Opus offers up to 256k so mono sources work too; MP3 retains 320k.
- Preview before you download — paste a link and see the title, duration and thumbnail; resolutions the video doesn't offer are dimmed, with size hints on the rest.
- Clips — download just a section (start → end). The existing exact-cut and lossless video options remain. Original audio preserves the stream, so its clip boundaries may be approximate.
- Thumbnail — save the cover image alongside the download. The same option is available in Audio mode and embeds the cover into MP3/M4A/Opus/FLAC when supplied by the site. WAV and Original keep a separate JPG; no audio conversion is added just to insert a cover.
- Subtitles — embeds the uploader's own subtitles into the file (best-effort; never blocks the download).
- Playlists — download a whole playlist into an auto-created folder; endless YouTube Mixes are safely capped.
- Login-only content — choose Chrome / Edge / Firefox / Brave / Zen and press the cookie button to collect the browser session. If extraction fails, a reason is shown and manual Netscape-format cookies.txt selection opens. Raw browser databases are not text exports. Valid cookies still need an account/session permitted to access the content; importing a file cannot guarantee access.
- Queue — press Download while one is running and the next link lines up behind it. Every entry gets its own row with the size, speed and time left, and you can drop one back out of the queue.
- Stop button — cancel the running download at any time.
- Updates itself — Settings names the version you are running and asks GitHub for the newest one when you open the panel. That check is a network request; Aevum makes three of those in total, and none of them go anywhere but GitHub. What it fetches is checked against the SHA-256 the release publishes before anything is opened.
- Keeps yt-dlp current on its own — the sites keep changing and yt-dlp keeps up, usually within days, while a release here takes weeks. The Packages line in Settings updates it in place, so a download that broke because YouTube moved something can be fixed without waiting for a new Aevum. It watches yt-dlp's stable and nightly channels — two of the three requests — and offers stable whenever stable is newer than the copy you have, falling back to a nightly only when stable is not. So a nightly is only ever a stopgap: the next stable that passes what you are running takes you back to it. It goes into your own folder, never the installed package, and one click puts the bundled version back. That is the rest of the three.
- 8 languages — English, Türkçe, Español, Deutsch, Français, Italiano, Português, Русский. Your choice is remembered.
- Self-contained — yt-dlp, FFmpeg and ffprobe are bundled; nothing else to install.
- No ads, no tracking — no adware, no bundled toolbars, no telemetry. Everything runs locally.
Aevum is a general-purpose front-end for yt-dlp. Only download content you have the right to save — your own uploads, Creative Commons material, sites that permit downloading, or your own paid accounts. You are responsible for how you use it. This project does not endorse or enable copyright infringement.
Aevum was vibe-coded with the help of an AI assistant — it was written collaboratively with AI rather than hand-coded line by line. I'm stating this openly so no one is misled about how it came to be.
The real heavy lifting is done by two excellent open-source projects — yt-dlp (the actual downloading) and FFmpeg (merging/converting). Aevum is essentially a clean, friendly, ad-free wrapper around them.
Requires Python 3.10+.
pip install flask pystray pillow pyinstaller
REM Place yt-dlp.exe, ffmpeg.exe and ffprobe.exe into a bin\ folder next to ytdl_tray.py
python -m PyInstaller --onefile --noconsole --name Aevum ^
--icon app.ico --version-file version.txt ^
--hidden-import pystray._win32 --collect-submodules pystray ^
--add-data "bin/yt-dlp.exe;." --add-data "bin/ffmpeg.exe;." --add-data "bin/ffprobe.exe;." ^
--add-data "fonts;fonts" ytdl_tray.pyOr just run build.bat. To preserve existing outputs and build a fresh Windows
release with tests, source ZIP, manifest and SHA-256 checksums, run:
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-release.ps1The isolated build writes to a new timestamped folder under releases/ and
refuses to overwrite an existing output folder. Installer and application UI
both offer all eight languages. Detailed audio/cookie messages are translated
in every language, including the automatic bitrate label.
The Zen chip after Brave uses yt-dlp's Firefox extraction with Zen's own
profile directory (firefox:<Zen profile root>), never the Firefox profile.
On Windows the normal location is %APPDATA%/zen/Profiles. Standard macOS,
Linux and Flatpak locations are also detected; custom/portable profiles can
use a manually exported cookie file. The upload/reset/session behavior is
identical to the other browser choices.
Select a browser, then press the cookie button to collect its cookies through yt-dlp's normal browser extraction. No video or network request is needed for this step. A check confirms collection, not permission to access every video. Browser selection without pressing the button still uses the existing cookies-from-browser behavior during previews and downloads.
If collection fails (missing profile, locked/encrypted database, empty jar or
timeout), a short reason is shown and manual selection opens. On Windows the
native picker starts in Downloads when available, since an exported file is
not normally in the hidden browser profile. Other platforms or a failed native
picker use the browser's file input. A small Select cookies.txt control stays
available if the browser blocks an asynchronous file dialog or you cancel it.
The helper below the choices changes with the selected browser. Manual import
needs a Netscape-format cookies.txt exported from your own signed-in session
using a cookie-export extension. This is not a file browsers create by default:
do not select Chromium's Cookies database or Firefox/Zen's cookies.sqlite.
Use a trusted exporter, export only what is needed, and never share the file.
A successful collection or import shows a small check and a remove control. It takes precedence over browser extraction for both preview and download. Changing browser or removing the file returns new jobs to browser extraction; jobs already queued retain the selection they were submitted with.
Imports exist only for the backend session, never in config or history. Each subprocess gets its own temporary copy; that copy is removed after the operation, while the session retains the import for more downloads. Closing Aevum clears the session and attempts to remove any remaining copies. The original file you selected is not changed or deleted. See SECURITY.
See the release checklist for build, test and update
compatibility checks. Local builds go under releases/; only the assets on
the GitHub Releases page are published releases.
Aevum's own code is released under the MIT License. It bundles third-party tools with their own licenses — see THIRD_PARTY_LICENSES.md. Notably, the bundled FFmpeg build is licensed under the GPL.
