SynapticSinner

BATCHARR SUPPORT Batcharr is a self-hosted bulk request and confirmation interface for Radarr and Sonarr. It allows users to submit mixed lists of movies and television series, review the matches returned by Radarr and Sonarr, approve or skip each result, and send the approved requests in bulk. Batcharr does not download media itself. Radarr and Sonarr handle searching, downloading, monitoring, and library management after a request is submitted. GITHUB GitHubGitHub - BMJ812/BatcharrContribute to BMJ812/Batcharr development by creating an account on GitHub.DOCKER IMAGE ghcr.io/bmj812/batcharr:latest MAIN FEATURES • Mixed movie and television lists • Copied external-list importing without an API account • Plain-text title entry • TXT, CSV, and JSON file imports • Optional direct TMDb public-list importing • Optional Discord slash-command integration • Radarr movie lookup and submission • Sonarr series lookup and submission • Radarr API v3 support • Sonarr API v3 and v5 detection • Poster, title, year, overview, destination, and confidence review • Alternate-match selection • Individual approve and skip controls • Bulk approval for high-confidence matches • Duplicate detection using TMDb and TVDb identifiers • Request history • Configurable root folders and quality profiles • Configurable monitoring and search-on-add behavior • Encrypted API-key and token storage • Optional password-protected WebUI • Persistent SQLite configuration and history • Unraid-friendly PUID and PGID support WEBUI IMPORT METHODS 1. EXTERNAL LIST This is the recommended method for copying a list from a website. Open the list webpage, copy the visible list contents, and paste them into Batcharr. Including ranking numbers and release years improves detection. Batcharr attempts to remove common webpage material such as: • Navigation labels • Ratings • Links • Cast-image captions • Repeated titles • Page metadata • Descriptive text The detected titles are still shown for review before anything is sent to Radarr or Sonarr. This method does not require a TMDb account, developer application, or API token. 2. PASTE TITLES Enter one movie or television title per line. Example: The Thing (1982) movie: Alien TV | The Expanse (2015) Dark - 2017 Release years are optional but strongly recommended when multiple titles share the same name. Supported media labels include forms such as: movie: film: tv: show: series: Unlabeled titles can be configured to: • Search both movies and television • Be treated entirely as movies • Be treated entirely as television series 3. UPLOAD FILE Supported file types: • TXT • CSV • JSON TXT files use the same format as the Paste titles field. CSV files require a header row. Supported columns are: title,year,type,tmdb_id,tvdb_id The title field is required. Supported type values include: movie film tv show series Providing a movie TMDb ID or television TVDb ID allows Batcharr to perform an exact lookup rather than relying only on title matching. JSON files may contain either: • A top-level array • An object containing an items array Example: { "items": [ { "title": "Alien", "year": 1979, "type": "movie", "tmdbId": 348 } ] } File imports are limited to 2 MiB and 200 unique titles. Uploaded file contents are parsed in memory and are not retained by Batcharr. OPTIONAL DIRECT TMDB IMPORT Direct TMDb public-list importing is available under the Advanced section of External list. This method accepts: • A public TMDb list URL • A numeric TMDb list ID It requires the server owner to provide a TMDb API Read Access Token. This integration is optional. Normal external-list importing does not require a TMDb account or token. Direct TMDb importing preserves exact TMDb IDs for movies. Television titles are resolved through Sonarr using their title and year. REVIEW AND APPROVAL WORKFLOW After Batcharr resolves a list, each title is displayed as a review card. Review the following before approving a result: • Poster • Title • Release year • Movie or television destination • Overview • Match confidence • Whether the title is already present Alternate matches can be selected when the first result is incorrect. Available actions include: • Approve • Skip • Approve high-confidence matches • Add approved titles • Clear the current review Batcharr does not submit pending or skipped titles. Items already in Radarr or Sonarr are marked as already present and are not submitted again. REQUEST HISTORY The History page records submitted requests and their results. History entries include: • Movie or series type • Title • Release year • Request status • Result message • Date and time A successful Batcharr request means the title was submitted to Radarr or Sonarr. It does not mean the media has finished downloading. DISCORD INTEGRATION Discord support is optional. Available slash commands include: • /movie — search for and request a movie • /show — search for and request a television series • /list — resolve and review a mixed list The /list command returns a summary showing: • Titles available to review • Titles already in the library • Titles that could not be resolved Users can select a title, review its poster and details, and then choose Request or Cancel. Discord review responses are private to the user who ran the command. Discord currently displays the first 25 available titles in the review menu because of Discord component limits. The Batcharr Settings page includes: • Application ID • Guild/server ID • Public key • Bot token • Optional allowed channel IDs • Optional allowed role IDs • Generated Interaction Endpoint URL • Generated bot installation URL • Test Discord button • Register commands button Allowed channel and role fields may contain comma-separated Discord IDs. FIRST-TIME WEBUI SETUP 1. Open the Batcharr WebUI. Default Docker Compose address: http://SERVER-IP:5058 The host port may be changed. Batcharr always uses container port 3000. 2. Open Settings. 3. Configure Radarr: • Radarr URL • API key • Root folder • Quality profile • Minimum availability • Monitor added movies • Search immediately Use Test and load Radarr options to verify the connection and retrieve available folders and profiles. 4. Configure Sonarr: • Sonarr URL • API key • Root folder • Quality profile • Series type • Monitoring mode • Season folders • Search missing episodes immediately Use Test and load Sonarr options to verify the connection and detect the installed Sonarr API version. 5. Save the settings. 6. Configure Discord or the optional TMDb integration only when those features are needed. UNRAID / DOCKER SETTINGS Repository: ghcr.io/bmj812/batcharr:latest Container port: 3000 Suggested host port: 5058 The host port may be changed when 5058 is already in use. Persistent configuration: /mnt/user/appdata/batcharr mapped to /config Suggested environment variables: PUID=99 PGID=100 TZ=America/Los_Angeles BATCHARR_PASSWORD=your-private-password BATCHARR_SECRET=your-stable-random-secret BATCHARR_COOKIE_SECURE=false BATCHARR_SECRET should be a stable random value containing at least 32 characters. Do not change BATCHARR_SECRET after saving Radarr, Sonarr, Discord, or TMDb credentials. Changing it prevents Batcharr from decrypting the credentials already stored in SQLite. Set BATCHARR_COOKIE_SECURE=true only when Batcharr is accessed through HTTPS. BATCHARR_PASSWORD may be left blank only when the WebUI is restricted to a trusted LAN, VPN, or Tailscale network. DOCKER NETWORKING When Batcharr shares a custom Docker network with Radarr and Sonarr, their container names may be used: http://radarr:7878 http://sonarr:8989 When using bridge networking, enter addresses that are reachable from inside the Batcharr container. Using localhost inside Batcharr will point back to the Batcharr container itself, not the Unraid host. UPDATING BATCHARR ON UNRAID 1. Open the Unraid Docker page. 2. Pull or check for container updates. 3. Select Force Update for Batcharr when necessary. 4. Preserve the existing /config mapping. 5. Preserve the existing BATCHARR_SECRET. 6. Reload the WebUI after the container is recreated. To pull the newest image manually: docker pull ghcr.io/bmj812/batcharr:latest CURRENT LIMITATIONS • One Radarr instance and one Sonarr instance • One shared WebUI password rather than individual user accounts • Maximum of 200 titles per WebUI import • Discord list review is limited to the first 25 available titles • External-list importing requires the user to copy visible webpage text • Batcharr submits requests but does not manage the download queue • Direct TMDb importing requires a user-supplied TMDb developer token SECURITY NOTES • Radarr and Sonarr API keys are encrypted before being stored • Discord secrets and TMDb tokens are stored server-side • Secret credentials are not returned to the browser after saving • Imported files are not retained • Signed Discord component values are validated before requests are accepted • Do not post API keys, bot tokens, passwords, or BATCHARR_SECRET in support messages REPORTING A PROBLEM Please include: • A description of what you were doing • Whether the issue occurred in the WebUI or Discord • The import method used • Whether Radarr and Sonarr connection tests pass • Browser and device information • Relevant screenshots with all secrets hidden • The latest Batcharr container logs • The running image revision when available Container logs: docker logs --tail 200 Batcharr Running image ID: docker inspect Batcharr --format='{{.Image}}' Published latest image ID: docker image inspect ghcr.io/bmj812/batcharr:latest --format='{{.Id}}' The running and latest image IDs should match after a successful update.