ARES Help

← Downloader About

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:

  1. Enter the username and password your administrator gave you.
  2. 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.
  3. Type the 6-digit code the app shows and submit.
  4. 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:

ItemMeaning
live / offlineWhether the live progress feed is connected. When it says offline, progress stops updating until it reconnects.
ffmpegWhether the server can merge, convert and embed. Without it, high-resolution video and audio extraction fail.
FolderYour private download folder on the server.
Help / AboutThis guide, and the app's version and author.
UsersAccount management. Only administrators see it.
Your nameThe account you are signed in as.
Sign outEnds 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

  1. Paste a URL into the box at the top.
  2. Press Enter or click Fetch. A card appears with the thumbnail, title, duration and uploader.
  3. Pick a Quality from the menu on the card.
  4. Click Download. The job joins the queue, and progress appears live.
  5. 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

  1. Paste a playlist or channel URL and click Fetch.
  2. A checklist of every item appears. Use Select all and Select none to work quickly, then tick what you want.
  3. 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.

StateMeaning
queuedWaiting for a free download slot.
downloadingIn progress.
processingMerging, converting or embedding metadata.
completeFinished and ready to play or save.
failedSomething went wrong. The reason is shown on the row.
canceledYou stopped it, or a server restart interrupted it.
ButtonWhat it does
▶ PlayPlays the file in the browser, with seeking.
SaveDownloads the file to the computer you are using. A copy stays on the server.
CancelStops a download in progress.
RetryQueues a failed or canceled job again with the same settings.
✕Removes the row from your queue. The file stays on the server.
Clear finishedRemoves 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.

OptionWhat it does
OutputVideo + audio, or Audio only to extract the sound track.
ContainerAuto keeps the site's format, which is fastest and loses nothing. Choose MP4, MKV, WebM or MOV if you need a specific one.
Audio codecIn audio-only mode: MP3, M4A/AAC, Opus, FLAC or WAV.
Audio qualityBest, High, Medium or Small for MP3, M4A and Opus. FLAC and WAV are lossless, so it does not apply.
Speed limitCaps the bandwidth a download may use, from 512 KB/s to 10 MB/s, or unlimited.
Subtitle languagesLanguage codes separated by commas, such as en or en,es,fr, or all.
Embed metadata, chapters & cover artWrites the title, tags, chapters and thumbnail into the file.
Download subtitlesFetches subtitle tracks in the languages above.
Include auto-generated captionsAdds machine-made captions as well as human ones.
Embed subtitles into the filePuts subtitles inside the video file instead of separate .srt files.
Strip sponsor segmentsCuts out sponsor sections that the SponsorBlock community has marked.
Overwrite existing filesReplaces 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.

  1. Start typing the site name and pick it from the suggestions.
  2. Enter your username or email and password for that site.
  3. 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.

  1. Choose the site, enter your username and password, and click Sign in.
  2. 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.

  1. Install a cookie exporter extension, such as Get cookies.txt LOCALLY for Chrome and Edge or cookies.txt for Firefox.
  2. 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.
  3. 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

  1. Click + New user.
  2. Enter a username of 3 to 32 letters, digits, dots, dashes or underscores.
  3. Leave the password blank to generate a strong one, or type one of at least 10 characters.
  4. Tick Administrator only if they should manage accounts. Leave two-factor authentication required.
  5. Copy the password with Copy password and give it to the person. It is shown only once.
ActionEffect
DeactivateBlocks sign-in and ends live sessions at once.
ActivateRestores access with the same password and authenticator.
Make / revoke adminGrants or removes account-management rights.
Reset passwordSets a new password, which they must change at next sign-in. Ends their sessions.
Reset 2FAClears their authenticator so they pair a new one. Ends their sessions. Confirm who you are talking to first.
Sign out everywhereEnds every session without changing credentials.
DeleteRemoves 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:

TabWhat it records
AuditSecurity 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.
ActivityEvery request that changes something: method, route (for example /api/admin/users/{user_id}), status, duration, user and source IP.
  1. Narrow the list with the filters (time range, user, action, outcome, path, method, IP, text) and click Apply.
  2. Click Export CSV or Export JSON to download exactly the filtered view. Exports are audited too.
  3. 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.

  1. 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.
  2. Choose the streams (audit, activity, application) and the minimum level, then Save.
  3. 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

KeyWhereAction
EnterURL boxFetch the URL, or queue every line if there are several.
Shift+EnterURL boxStart a new line for another URL.
EscURL boxClear the box and dismiss the result card.
EscPlayerClose the player.

15. Troubleshooting

Message or symptomWhat to do
Sign-in required, or a sign-in wallThe site needs an account. Add one under Site sign-ins.
It worked yesterday, now it failsYour cookies have probably expired. Check the badge in Site sign-ins and upload fresh cookies.
The site refused this requestSome 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 trackThe source has no sound, so audio-only extraction has nothing to save.
ffmpeg pill shows a problemAsk the administrator to install ffmpeg. Until then, choose single-file streams.
Progress stopped, pill says offlineThe live feed dropped. It reconnects on its own. Reload the page if it does not.
Job shows canceled after a restartClick Retry to start it again.
Video won't play in the browserClick Save and open it in a desktop player, or download it again as MP4.
Two-factor code rejectedWait for the next code, and make sure your phone's clock is set automatically.
Account lockedWait 15 minutes, then sign in carefully.
Netflix, Disney+ or similarDRM-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.