App Settings

The Settings section manages gdluxx itself, not your downloads or config, but the application. You'll find tabs for different types of settings here.

General Manager

• Go to Settings > General Manager

Command Form

Site Rule Override Warnings

gdluxx can warn you when your manual options conflict with a site rule. It's a simple on/off toggle

You can turn them back on anytime. See Site Rules for more info about how this works.

Having a conflict does not mean you can't still run jobs.

• See Site Rules & Manual Options

Max Batch URLs

Controls how many URLs the browser extension can submit in a single request (e.g. sending an entire page of links at once). Defaults to 200 and accepts any whole number between 1 and 10,000.

See API Limits below for how this setting interacts with the external API.

Theme Selection

1. Click your preferred theme
2. Changes apply immediately

For details on available themes, see Themes.

Version Manager

This manages the gallery-dl binary that does the actual downloading.

Check Current Version

1. Go to Settings > Version Manager
2. You'll see:
   • Your current gallery-dl version
   • The latest available version (after clicking "Check for Updates")
   • Whether you're up to date
   • The release source gdluxx is checking, with a link to it - either GitHub or Codeberg, depending on your build
   • An ARM64 badge if you're running the ARM64 build

Update gallery-dl

To download a new version is available:

1. Click Check for Updates
2. If an update exists, click Download or Update
3. The new binary is downloaded and installed automatically
4. No restart needed, it's ready once you receive the notification "Update completed successfully"

Why Update?

Site support breaks sometimes (sites change their HTML, add authentication, etc.). The gallery-dl maintainers usually fix these quickly.

If downloads suddenly stop working:

1. Update gallery-dl first
2. Try the download again
3. If it still fails, check the gallery-dl GitHub issues to see if others are experiencing the problem

User Manager

Currently, shows your account information. More features may be added in the future.

API Key Manager

This is where you create and manage API keys for external access (browser extension, scripts, or anything else you dream up).

Creating an API Key

1. Go to Settings > API Key Manager
2. Give it a name (e.g., "Chrome Extension", "Mobile Script")
3. Set an expiration, or don't
   • No date given: the key expires after 1 year by default
   • Toggle on "Never expires?": the key stays valid until you delete it
   • Or choose a specific date/time; at most 365 days out
4. Click Generate Key
5. Copy the key immediately as you'll only see it once

There is no recovering an API key

If you lose track of your API key, or it becomes otherwise compromised, delete it. You can easily generate a new key. Treat them like you would a password. It shouldn't matter too much, because you're not exposing gdluxx to the internet, right?

Using Your API Key

Use it in API requests:

curl -X POST \
  -H "Authorization: Bearer YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"urlToProcess": "https://example.com"}' \
  https://your-gdluxx-url/api/extension/external

An API key is necessary to use the browser extension.

Managing Keys

• View all keys: The Key Manager lists all of your active keys
• See when they expire: Each key shows its expiration date (if set)
• Older keys never expire: keys created before gdluxx added the 1-year default have no expiration date and stay valid until you delete them
• Revoke a key: Click delete/trash icon to immediately revoke access
• Create multiple keys: You can have as many keys as you want

Useful for:

• Separate keys for extension and scripts
• Revoking old keys when you lose track of them
• Expiring keys regularly for security

API Limits

• Max Batch URLs: 200 by default, configurable per-user in Settings > General Manager. Accepts any whole number from 1 to 10,000, and there's an absolute hard cap of 10,000 that can't be raised.
• This limit is enforced. A request with more URLs than your configured maximum is rejected outright, rather than silently truncated or queued.

Note

While you can go wild with gdluxx, be mindful some sites may rate limit, temporarily ban, or outright ban you if you hammer their site.

Be respectful, be smart

Extension Profiles

• Go to Settings > Extension Profiles

This tab shows the extraction profile backups synced from the gdluxx browser extension, the per-site rules the extension uses to pull content out of a page (start/end selectors, substitution rules, gallery display options). Backups are stored per API key, so pick the key you want to inspect from the dropdown at the top.

What You Can Do

• View profiles: See every synced extraction profile for the selected key - its scope (host, origin, or path), extraction mode, substitution rule count, and when it was last synced or used.
• Edit or create profiles: Use New profile or Edit to change a profile's selectors, substitution rules, and gallery display options directly in gdluxx, without touching the extension.
• Delete a profile or a whole backup: Remove a single profile, or wipe the entire backup for that API key.
• Export/Import: Export profiles downloads the backup as JSON; Import profiles lets you paste or upload JSON to restore it. Profiles with a matching ID are overwritten - everything else is left alone.

Note

Restoring a backup into the extension (rather than editing it here) shows a preview of what will change before anything is overwritten. That preview happens in the extension's own UI, not on this settings page.

Older extension versions synced separate "selector" and "substitution" backups instead of extraction profiles. If you still have any, they appear in a collapsed Legacy backups section so you can review or delete them.

Cookies

• Go to Settings > Cookies

This page shows the cookies synced from the browser extension's Cookies tab, organized per API key since that's how the extension authenticates. Pick a key from the dropdown to see which domains have synced cookies, how many, and when they were last updated.

You can delete a single domain's cookies or clear an entire key's backup. Deleting doesn't touch your browser - sync again from the extension's overlay if you want them back.

See Cookie Sync for how synced cookies get applied to your downloads.

Security Note

Cookies are session-equivalent secrets. gdluxx stores them as plain text in the database and in the cookie files it writes for gallery-dl - there's no encryption at rest. Treat your gdluxx data directory with the same care as your browser's own cookie store. Cookie values are never shown or returned by the API once synced.

Log Manager

Configure if, where, and how gdluxx logs its activity.

Note

There are two parts to the Log Manager, Server and Client. They're exactly what they sound like.

• Client: Browser UI
• Server: Backend magic

If you're wanting to view logs in the console and not a file, make note of the below.

• Client console: Is your browser console, F12 should get you there on all browsers (except maybe Safari, I know less about Macs than I do Windows)
• Server console: Available in your docker logs

Server Logging

Log Levels

You can adjust how verbose logging is:

• Debug: Detailed debugging information
• Info: Standard information (default)
• Error: Only show errors
• Warn: Show warnings and errors

Debug mode shows more details but creates larger log files.

Log Format

• Simple = Single line logs
• JSON = JSON formatted logs

Enable Logging to File

When logging is enabled, by default, logs go to console only. To save logs to a file:

1. Go to Settings > Log Manager
2. Toggle on "File Output"
3. Enter a path where logs should be saved (e.g., /app/data/logs/)
4. Save

Log Directory

Defaults to logs/ in your docker bind mount location.

Additional settings

• Max File Size (before creating a new file)
• Max number of days to keep log files before deleting
  • Old log files will be deleted

Client Logging

Log Levels

Same as Server Logging above

Send Logs to Server

By default, the logs will only print to the browser console. You can opt to send them to the server if you want them written to file. There are a couple of additional settings for doing this.

• Buffer size: How many log lines before the logs are sent to the server

• Batch Interval: Minimum time between sending logs to the server

• You can opt to include the URL and/or the User Agent in logs as well (it's not by default)

When to Enable Logging

Enable file logging if:

• You're troubleshooting download issues
• You want to review what happened during jobs
• You're debugging configuration problems
• You need a record of all activity

You can disable it later if you don't need logs anymore.

Security Note

In general, logs can contain sensitive information. API keys, URLs, and User Agent are left out of gdluxx logs by default. You can opt to add URLs and User Agent to logs, but not API keys.

Keep your logs private! Don't share them on public forums without reviewing them first. Better safe than sorry

gdluxx tries to sanitize logs (redacting passwords), but you should still be cautious.