How to use ARES VideoDownloader
ARES fetches video from the web, streams it in your browser and saves it to disk. It supports roughly 1,800 sites through yt-dlp, plus direct MP4, HLS and DASH links. This page covers every screen and option.
1. Signing in
Every sign-in needs two things: your password and a 6-digit code from an authenticator app on your phone.
The first time you sign in, you pair your authenticator:
- Enter the username and password your administrator gave you.
- A QR code appears. Scan it with Google Authenticator, 1Password, Bitwarden, Aegis, Authy or any other TOTP app. If you can't scan it, expand Can't scan? Enter the key manually and type the key into the app.
- Type the 6-digit code the app shows and submit.
- If an administrator set your password, you are asked to choose a new one of at least 10 characters.
After that, enter your password, then a fresh code from the app. Start over takes you back to the password step.
- Codes change every 30 seconds, and each code works only once. If a code is rejected, wait for the next one.
- Your phone's clock must be correct. Turn on automatic time if codes keep failing.
- Five wrong passwords lock the account for 15 minutes. The lock clears on its own.
- A session lasts 12 hours. After that you sign in again.
2. The main screen
The bar across the top shows the state of the app:
| Item | Meaning |
|---|---|
| live / offline | Whether the live progress feed is connected. When it says offline, progress stops updating until it reconnects. |
| ffmpeg | Whether the server can merge, convert and embed. Without it, high-resolution video and audio extraction fail. |
| Folder | Your private download folder on the server. |
| Help / About | This guide, and the app's version and author. |
| Users | Account management. Only administrators see it. |
| Your name | The account you are signed in as. |
| Sign out | Ends this session. |
Below it, from top to bottom, are the URL box, Download options, the result card for the link you fetched, and the Queue.
3. Downloading a video
- Paste a URL into the box at the top.
- Press Enter or click Fetch. A card appears with the thumbnail, title, duration and uploader.
- Pick a Quality from the menu on the card.
- Click Download. The job joins the queue, and progress appears live.
- When it completes, click ▶ Play to watch it, or Save to copy it to your computer.
Clear, or the Esc key, empties the box and dismisses the card.
Several videos at once: paste several URLs, one per line, and press Enter. They go straight into the queue without a quality menu, using your current Download options. Use Shift+Enter to start a new line.
4. Choosing a quality
The Quality menu has two parts.
- Presets such as Best available or 1080p or lower. These pair the best video with the best audio automatically. Use them unless you need a specific stream.
- Individual streams, grouped by type. Single-file streams already hold video and audio. Video only streams are paired with the best audio for you. Audio only streams are there if you want one in particular.
File sizes are shown where the site reports them.
5. Playlists and channels
- Paste a playlist or channel URL and click Fetch.
- A checklist of every item appears. Use Select all and Select none to work quickly, then tick what you want.
- Click Add selected to queue.
Each item becomes its own queue row, with its own progress and its own file. Several download in parallel, and the rest wait for a free slot. Very long playlists are cut off at a limit the administrator sets.
6. The queue
Each row shows the title, a progress bar, the percentage, the amount downloaded, the speed and the time remaining. HLS and DASH streams show a fragment count instead of bytes.
| State | Meaning |
|---|---|
queued | Waiting for a free download slot. |
downloading | In progress. |
processing | Merging, converting or embedding metadata. |
complete | Finished and ready to play or save. |
failed | Something went wrong. The reason is shown on the row. |
canceled | You stopped it, or a server restart interrupted it. |
| Button | What it does |
|---|---|
| ▶ Play | Plays the file in the browser, with seeking. |
| Save | Downloads the file to the computer you are using. A copy stays on the server. |
| Cancel | Stops a download in progress. |
| Retry | Queues a failed or canceled job again with the same settings. |
| ✕ | Removes the row from your queue. The file stays on the server. |
| Clear finished | Removes every completed, failed and canceled row at once. |
⚠ Complete with a warning means the video downloaded fine but an extra, usually cover art or chapters, could not be added. The file is kept and works normally.
7. Playing and saving
▶ Play opens the player over the page. Use the normal video controls to pause, seek, change volume or go full screen. Save to disk under the video downloads the file. Close ✕ or Esc closes the player.
Some formats, such as MKV with certain codecs, may not play in every browser. Save the file and open it in a desktop player like VLC instead, or choose MP4 as the container next time.
8. Download options
Click Download options under the URL box to open the panel. The line beside it summarises what is set. The settings apply to everything you queue afterwards.
| Option | What it does |
|---|---|
| Output | Video + audio, or Audio only to extract the sound track. |
| Container | Auto keeps the site's format, which is fastest and loses nothing. Choose MP4, MKV, WebM or MOV if you need a specific one. |
| Audio codec | In audio-only mode: MP3, M4A/AAC, Opus, FLAC or WAV. |
| Audio quality | Best, High, Medium or Small for MP3, M4A and Opus. FLAC and WAV are lossless, so it does not apply. |
| Speed limit | Caps the bandwidth a download may use, from 512 KB/s to 10 MB/s, or unlimited. |
| Subtitle languages | Language codes separated by commas, such as en or en,es,fr, or all. |
| Embed metadata, chapters & cover art | Writes the title, tags, chapters and thumbnail into the file. |
| Download subtitles | Fetches subtitle tracks in the languages above. |
| Include auto-generated captions | Adds machine-made captions as well as human ones. |
| Embed subtitles into the file | Puts subtitles inside the video file instead of separate .srt files. |
| Strip sponsor segments | Cuts out sponsor sections that the SponsorBlock community has marked. |
| Overwrite existing files | Replaces a file that already exists instead of skipping it. |
9. Sites that need you signed in
Some sites refuse visitors who are not logged in. A video can play in your browser and still fail to download, because your browser is signed in and the server is not. The Site sign-ins box at the bottom of Download options gives the server a sign-in. It offers three methods, and shows only the ones that can work for each site. Everything in it is private to your account.
Save a password. This is the best choice where it is offered, and works for about 85 sites, including Vimeo, Twitch, SoundCloud, Dailymotion, Nebula, Udemy and VK.
- Start typing the site name and pick it from the suggestions.
- Enter your username or email and password for that site.
- Click Save.
The password is encrypted on the server and never sent back to the browser. It does not expire. If the site starts rejecting it, the entry turns red.
Sign in with a browser. Facebook, Instagram, TikTok, X and YouTube have no password login that yt-dlp can use. For these, the server can open a real browser, sign in as you and keep the cookies.
- Choose the site, enter your username and password, and click Sign in.
- If the site asks for a verification code, the panel shows a screenshot of the site and a box for the code. Enter it and click Submit, or Cancel to give up.
The password is used once and not stored. Sites are often wary of logins from a server, so a security check or captcha is normal. YouTube usually refuses automated browsers, so expect to use cookies.txt for it. This method needs Playwright on the server. If it is missing, the panel says so.
Upload cookies.txt. This always works, for any site, but cookies expire and have to be renewed.
- Install a cookie exporter extension, such as Get cookies.txt LOCALLY for Chrome and Edge or cookies.txt for Firefox.
- Visit the site while signed in and export
cookies.txt. For YouTube and Google, do this in a private window, then close it without browsing further. YouTube replaces the session as you browse, which makes an exported copy stop working. - Click Upload cookies.txt and choose the file. You can pick several files at once.
Each upload replaces only the sites in that file, so adding YouTube leaves Facebook alone. The list shows each site and when its cookies expire. The badge at the top of Site sign-ins warns as expiry approaches, and expired sites show in red. The ✕ beside a site removes only that site, and Remove all deletes every cookie.
Cookies and saved passwords are live credentials. Anyone who gets them can act as you on those sites. Only add them to a server you trust, export cookies only for the sites you need, and remove them when you are done.
10. Your account and privacy
- Your queue, history and files are visible only to you. Each account has its own folder on the server.
- Administrators manage accounts, not content. They cannot see your downloads.
- Changing your password: the app asks you to change it whenever an administrator has set or reset it. To change it at any other time, ask an administrator to reset it. Changing your password signs out your other sessions.
- Lost your phone? Ask an administrator to reset your two-factor authentication. You pair a new device at your next sign-in.
11. For administrators
Click Users in the top bar to manage accounts.
Creating a user
- Click + New user.
- Enter a username of 3 to 32 letters, digits, dots, dashes or underscores.
- Leave the password blank to generate a strong one, or type one of at least 10 characters.
- Tick Administrator only if they should manage accounts. Leave two-factor authentication required.
- Copy the password with Copy password and give it to the person. It is shown only once.
| Action | Effect |
|---|---|
| Deactivate | Blocks sign-in and ends live sessions at once. |
| Activate | Restores access with the same password and authenticator. |
| Make / revoke admin | Grants or removes account-management rights. |
| Reset password | Sets a new password, which they must change at next sign-in. Ends their sessions. |
| Reset 2FA | Clears their authenticator so they pair a new one. Ends their sessions. Confirm who you are talking to first. |
| Sign out everywhere | Ends every session without changing credentials. |
| Delete | Removes the account and its history. You are asked separately whether to delete their files. |
To prevent lock-outs, you cannot deactivate or delete yourself, or remove the last administrator. Every one of these actions is recorded in the audit log.
12. Audit & Activity
Administrators open Audit in the top bar of the Users
page (or go to /admin/audit). There are two tabs:
| Tab | What it records |
|---|---|
| Audit | Security events: sign-ins and failed attempts, 2FA enrolment and failures, lockouts, password changes and resets, account and role changes, sessions revoked, cookie and site sign-in changes, retention and log-forwarding changes, exports and denied admin access. Each entry has the time, the user, the action, the object, the outcome (success / failure), source IP and user agent. |
| Activity | Every request that changes something: method,
route (for example /api/admin/users/{user_id}), status,
duration, user and source IP. |
- Narrow the list with the filters (time range, user, action, outcome, path, method, IP, text) and click Apply.
- Click Export CSV or Export JSON to download exactly the filtered view. Exports are audited too.
- Under Retention, set how many days each stream is kept (defaults: audit 365, activity 90). Older entries are pruned hourly.
The log is append-only. Nobody, including administrators, can edit or delete entries; they leave only when they pass the retention period.
13. Log forwarding to a SIEM
Log forwarding (/admin/log-forwarding)
sends audit, activity and application events to a log collector or
SIEM, one ECS JSON object per event.
- Click + Add destination and pick the type:
- HTTP(S) NDJSON: a URL plus an auth header,
e.g.
Authorization: Splunk <token>for Splunk HEC (/services/collector/raw),ApiKey …for Elastic,Bearer …for a Loki or Wazuh gateway. - Syslog: host, port and transport (UDP 514, TCP 601, TLS 6514), RFC 5424 with the JSON event as the message.
- HTTP(S) NDJSON: a URL plus an auth header,
e.g.
- Choose the streams (audit, activity, application) and the minimum level, then Save.
- Click Send test event and check that it arrived.
Each destination shows events sent, failures, dropped events, the backlog and the last error. Audit and activity are delivered at least once: if the collector is down, ARES retries with growing pauses (up to five minutes) and catches up from its database when it is back. Credentials are stored encrypted and are never shown again. TLS certificates are verified unless you untick it, which the page marks as unsafe. A destination set by the operator at deploy time shows as from the environment and cannot be changed here.
14. Keyboard shortcuts
| Key | Where | Action |
|---|---|---|
| Enter | URL box | Fetch the URL, or queue every line if there are several. |
| Shift+Enter | URL box | Start a new line for another URL. |
| Esc | URL box | Clear the box and dismiss the result card. |
| Esc | Player | Close the player. |
15. Troubleshooting
| Message or symptom | What to do |
|---|---|
| Sign-in required, or a sign-in wall | The site needs an account. Add one under Site sign-ins. |
| It worked yesterday, now it fails | Your cookies have probably expired. Check the badge in Site sign-ins and upload fresh cookies. |
| The site refused this request | Some sites block automated clients. ARES retries once posing as a browser. If it still fails, try again later or add a sign-in. |
| No audio track | The source has no sound, so audio-only extraction has nothing to save. |
| ffmpeg pill shows a problem | Ask the administrator to install ffmpeg. Until then, choose single-file streams. |
| Progress stopped, pill says offline | The live feed dropped. It reconnects on its own. Reload the page if it does not. |
| Job shows canceled after a restart | Click Retry to start it again. |
| Video won't play in the browser | Click Save and open it in a desktop player, or download it again as MP4. |
| Two-factor code rejected | Wait for the next code, and make sure your phone's clock is set automatically. |
| Account locked | Wait 15 minutes, then sign in carefully. |
| Netflix, Disney+ or similar | DRM-protected services are not supported and will not work. |
A word on what you download. Being able to download something is not the same as having the right to republish it. Check the site's terms and the licence of the material. Copies of your own uploads, openly licensed work, or material you may archive are the intended use.