Soulseek arrives as an opt in source: add a slskd client and interactive search lists what Soulseek peers offer, with a Grab button that downloads and imports it. Light novels can get their official English titles from RanobeDB, you can add a book by hand when no metadata source knows it, and editions, narrators, durations and ASINs gain field locks. Settings General is split into four tabs, the Queue gets status chips, and the web UI's status colours now come from one set of named tokens. There are two database migrations (135 and 136), so take a backup first. Behaviour changes are listed below.
The migrations run on their own at startup and nothing needs doing by hand. 135 adds a column for edition locks and 136 adds a column that tells a torrent your client never received from one you removed. Torrents that keep failing are now blocklisted after three counted failures, and an indexer that answers with an error is left alone for a while instead of being hammered. Changing the address of a connected service now clears its saved key, so enter the key again after moving a server.
Upgrade notes
- Rolling back to v1.52.0 does not work without restoring a backup, so take a backup before upgrading. Migrations 135 and 136 stay recorded in the database, and the v1.52.0 binary refuses to start on a
schema_migrationstable with versions it does not know. It stops at startup with "schema_migrations contains version 127 that is neither a valid migration filename number nor a valid legacy index", where 127 is only the first version its check trips on. The database is not damaged. To go back, stop Bindery, restore the backup taken before the upgrade and start v1.52.0. Anything saved after the upgrade is lost with it. - Migration 135 adds
editions.locked_fields(#3216). It is additive. Every existing edition starts with an empty list, so nothing is locked until someone edits an edition or sets a lock through the API. - Migration 136 adds
downloads.client_seen_at(#4111). It marks every download that is Grabbed or Downloading when the upgrade runs as already seen by its client, so an upgrade cannot make an old row look like a torrent that never arrived. Finished and failed rows are left alone. Its Down section drops the column. - A torrent that keeps failing is now blocklisted, and an indexer that errors is backed off (#4119, refs #4111). Before, only usenet failures and stalls reached the blocklist, and a dead torrent was retried every six hours for ever. Now a torrent release is blocklisted after 3 counted failures in a row, at least an hour apart and inside seven days, and an import in between resets the count. Only two kinds of failure count: the indexer answering 404 or 410 for the download link, and a torrent that never reached the client. They count only while the indexer was sending other releases to a client since the release last failed, and not when any other release from that indexer failed in the last 24 hours, so a broken indexer cannot take good releases down with it. A torrent your client reports as errored (usually a full disk), an unreachable client, a timeout or a rejected login never count. An indexer answering 429, a 5xx or a "disabled till" notice is left alone for the time it asked for (between 5 minutes and 24 hours), or an hour when it gave none, and its releases are not blocklisted. A torrent you removed in your client, or one the client lost after it had listed it, is recorded and grabbed again but never counted. Usenet behaves as before. A blocklist entry made this way has no expiry and applies to the release for every account, like the usenet ones. History says what happened using the class and status only, never text copied from an error, since that can carry an indexer URL with an API key. A dead release alone on a quiet indexer can still need a manual blocklist from the History page.
- Editing a service address now clears the saved key unless you send a new one (#3944, #4082, #4117, #4122). A credential belongs to the server it was issued for, so moving the address no longer sends it to the new one. Saving the Audiobookshelf or BookOrbit settings with a different base URL and no new key clears the saved key. Saving the Grimmory settings (
PUT /api/v1/grimmory/config) with a different server URL clears the saved key and password unless you send new ones. The genericPUTandDELETE /api/v1/setting/{key}do the same forgrimmory.base_url,abs.base_url,bookorbit.base_urlandcalibre.plugin_url, and the response carriescredentialsCleared, the names of the settings it cleared and never their values. Updating an indexer or a Prowlarr connection with a different URL and no newapiKeyclears the key. Updating a download client clears the API key, password and proxy password when its type, host, port, TLS setting or URL base changes and you send no new ones in the same save. A trailing slash, capital letters in the host or an explicit default port are not a move. Indexers synced from Prowlarr keep their own key until the next sync. If you script any of these, send the credential in the same request as the new address. The Grimmory test button also no longer sends saved credentials to an address that has not been saved. - Settings, General is now four tabs (#3990). General holds Appearance and Security. File Naming (import mode, content checks, drop folders, import source folders, the
metadata.opfsidecar and the naming templates) and Storage (download and library folders, the database check, Scan Library, Reorganize Library and the default library location) sit under Library. Schedules (reject words, preferred language and the search, Hardcover sync, library scan, release discovery and series check intervals) sits under System. Every setting keeps its key. A link such as/settings?tab=general#import.modestill lands on the field, and?tab=generalwith no key still opens General. POST /api/v1/library/scanis admin only when multi user login is enforced (#4095). A non admin account, or a request with no role, now gets 403. Admins, API key requests and installs without logins behave as before.- A request for a book someone else owns, or a shared one, answers 409 with a note to ask an admin (#4088). With multi user enforcement on, a requester or user who asks for a missing format of a book they cannot change gets "This book is in a shared library you can't change, so ask an admin to add that format." instead of a message claiming the book is already in the library. A request an admin files for them, or one already pending, stays pending, and a requester's auto approval no longer adds the format or starts a search for it. An admin approving by hand, and installs with enforcement off, are unchanged.
- The Queue has new status chips and the History messages changed (#3992, #3993, #4119). Held, Handed off and Needs attention rows no longer count as Active. The older
?view=activeand?view=failedlinks still work. A Handed off row has a Scan library button for admins. A failed torrent now says in History whether the indexer no longer serves it, it never reached the client, or the indexer is being backed off, and a blocklisting says it was the third failure in a row. - The web UI looks slightly different (#3994, #4116). Status colours moved to named tokens with light and dark values. Banners and alerts have a slightly stronger tint (for example light warning moves from rgb(255,251,235) to rgb(254,243,198)), their hover is a little darker, and chip text on the translucent washes in the dark theme is a lighter shade for better contrast. Solid fills that put white text on amber, green or sky now use the 700 shade, so the pending requests count, the Calendar today marker and a few buttons are a touch darker. Toggles, Switches and the setup progress segments move from emerald 600 to 700. A text colour that had no dark variant now flips to a readable one. The contrast test measures every pair in both themes.
- RanobeDB and slskd are opt in (#2012, #1717). Neither does anything until you switch it on. RanobeDB's data is ODbL and its API is for non commercial use. Contains information from RanobeDB, which is made available here under the Open Database License (ODbL). See
docs/third-party-data.md. Soulseek searches put the title and the author's last name on the Soulseek network as search text, and downloading shows your IP address to the peers you download from, so read the privacy section of the deployment guide first. - Helm users: the chart gains
metrics.serviceMonitor,metrics.prometheusRuleandmetrics.dashboard, each withenabled: false, andnetworkPolicy.metricsFrom(an empty list). The rendered manifests are unchanged unless you set them. The ServiceMonitor and the rules only render when the cluster servesmonitoring.coreos.com/v1. - Calibre Bridge users, a note for the separate bindery-plugins releases. The next Calibre Bridge release is not part of Bindery's image, and when it ships it changes a few defaults (its changelog). The bridge refuses ingest paths and covers whose extension is not a book or image format (
400 bad_format). Its failed key throttle now counts only failed attempts and no longer rate limits key guessing from a blocked address, so use a generated key of at least 32 random characters. Its Helm chart requirespluginSha256unless you setallowUnpinnedPlugin: true.
Added
- Soulseek through slskd: add the client, search it, and grab from it (#1717). slskd is the Soulseek daemon, and Bindery talks to slskd's REST API and never speaks the Soulseek protocol itself. It is opt in and does nothing until you add and enable a slskd client under Settings, Download Clients. Test and Diagnose check that slskd answers, runs 0.26.0 or newer, is logged in to Soulseek, that its API key has a write role (
readwriteoradministrator, since slskd's default keys are read only), and that its downloads folder is readable through your path remap. Whether a port is forwarded cannot be detected, so that row is informational only. With a client enabled, interactive search also searches Soulseek and lists what peers offer beside your indexer results. Each result carries a Soulseek badge, the peer's user name, how many files the folder holds, and whether the peer has a free slot or how long its queue is. The Grab button works on them. Bindery asks slskd for the files of the folder you picked, shows the download in the Queue with the peer's name and its place in the peer's upload queue, and imports the finished files through the normal import. The files land in slskd's downloads folder underbindery/<download id>/, so slskd and Bindery have to share that volume or the client's path remap has to reach it. A download counts as finished only when every file arrived. If one file fails, the whole download fails and is cleaned up, and a download that sits queued for 30 minutes or receives no bytes for 10 minutes is cancelled in slskd and failed, so you can pick another result. Removing it from the Queue cancels it in slskd. Files from peers are checked in block mode on import: a wrong format, an EPUB or Kindle file that will not open or is a different book, audiobook tags for another book, or a language your profile does not allow is refused and blocklisted, unless you set that content check to off. PDF has no content check. Grabbing is by hand only: the automatic search for wanted books never uses Soulseek, and nothing is grabbed from Soulseek without you pressing Grab. The title and the author's last name you search for leave your machine as search text on the Soulseek network, and slskd runs one search at a time, so a search that includes Soulseek usually takes about 15 seconds longer. Bindery waits at most 20 seconds for slskd, then shows your indexer results without it. The deployment guide covers setup, what Soulseek exposes about you and the limits. - RanobeDB titles for light novels (#2012). An opt in metadata source, off by default: when on, a light novel you add gets its official English title from RanobeDB, but only for a match with a clear best score, the same volume numbers and a matching author, never for a book with no author name, and never over a locked title. It applies to books added after you switch it on, and existing books keep their titles. Settings, Metadata. RanobeDB's data is ODbL and its API is for non commercial use; see
docs/third-party-data.md. Thanks koseozgur. - Editions have field locks (#3216).
PUT /api/v1/book/{id}/edition/{editionId}sets an edition's publisher, publish date, ISBN-13, ISBN-10 and ASIN and locks each one whose value changes, so writing back an edition as GET returned it locks nothing.publishDatetakesYYYY-MM-DDor the RFC 3339 timestamp GET returns, andpublisheris capped at 500 bytes; both edition upserts honor the lock inside the write, including when they would otherwise fill an empty column. The PUT answers 409 when an import or another edit changed the edition while the request was being handled.GET /api/v1/book/{id}now carries the book'seditionswhen it has any, each with itslockedFields, so a client can find theeditionIdto edit. A re-bind keeps an edition with a lock instead of dropping it with the old record's other provider editions (migration 135). Thanks chemicalsno. - Narrator, duration and ASIN can be locked (#3216). Changing any of the three on a book through the API or the ASIN box locks it, the way title and description already locked, so Audiobookshelf re-imports, Audnex enrichment, Hardcover hydration and Hardcover list syncs keep your value. Thanks chemicalsno.
- Add a book by hand (#3840). The Add to library dialog has an Add by hand step for a book no metadata source knows, such as a short story, an anthology piece or a fan translation: type the title and author, and optionally a series with the position, the format and whether to search. Nothing is looked up. An author already in your library is reused and any other name becomes an author with no metadata, which Link metadata connects later. Metadata refreshes leave these books alone, the title is locked so Audiobookshelf and Calibre imports keep it, an Audiobookshelf import does not relink it, an author refresh that finds a work with the same title neither attaches it to the book nor adds a second copy, and Re-bind links one to a real record when you want. The API is
POST /api/v1/author/book/manual. Thanks NopeCharon. - Helm chart monitoring (#3851). The chart can now render a Prometheus Operator ServiceMonitor, a PrometheusRule with a small set of alerts, and a Grafana dashboard ConfigMap, each behind its own
metrics.*.enabledvalue and off by default. The ServiceMonitor and rules only render when the cluster has the monitoring.coreos.com API.networkPolicy.metricsFromlets a Prometheus in another namespace through the NetworkPolicy. Suggested thresholds are indocs/monitoring.md. - Current value under each Settings label (#3989). Settings that hold a choice, a switch or a saved value now show what is set right now in a quiet line under the label, such as "Current: Hardlink" or "Current: Default (12 hours)". The line reads the same state as the control, so it changes when a save lands and goes back if a save fails. The Edit Author dialog has the same line under its profile, root folder and monitor fields, showing what is saved for that author, so it does not move while you pick and shows the new value the next time you open the dialog after saving. Secrets such as API keys and tokens only ever show Set or Not set, a saved URL never shows a user name or password, and long folder paths are cut to one line with the full path on hover. Fields with their own Save button are not included, since what you typed there is not saved yet.
- A Scan library button on handed off Queue rows (#3993). A Queue row handed off to your external import tool now has a Scan library button, so the next step is on the row instead of only Remove. It runs the same library scan as Settings, which picks up the file the external tool placed in your library so the book shows as owned. The row itself stays under Handed off until you remove it. The button is shown to admins, because the scan walks the whole library, and it says so plainly when a scan is already running.
Changed
- The ASIN re-map inside Enrich keeps your locks (#3216). It used to clear every lock as if you had re-bound the book. Re-bind still clears the work field locks (title, description, genres, language, release date) but keeps narrator, duration and ASIN locks, because it keeps those values.
- Rolling back an Audiobookshelf import leaves a locked narrator, duration or ASIN alone (#3216), even when the value still matches what the run wrote. The import's book writes and the Hardcover list sync's widen now refuse a stale snapshot, so a lock set while a run is in progress is kept.
- Narrator, duration and ASIN lock on
PUT /book/{id}when their value changes (#3216). Sending a field with the value it already has locks nothing, so a client that reads a book and writes the whole object back changes no locks, and{"asin": ""}on a book with no ASIN is not a lock. Naming a field inlockedFieldsstill locks it without a change. The same rule now applies to title, description, genres, language and release date.asinis normalized to upper case and, when it changes, must be ten letters or digits.narratoris capped at 1000 bytes anddurationSecondsat 3600000 (1000 hours); both are a 400 above that.durationSecondswas ignored before;0still means not set, and a negative value is a 400. "Unlock all fields" in the edit dialog also unlocks narrator, duration and ASIN. releaseDateonPUT /book/{id}also takes the RFC 3339 timestamp GET returns (#3216), so writing back a book you just read no longer fails with a 400.- A lock set from the ASIN box shows only the page's general lock badge (#3216). The edit dialog badges its own five fields and offers "Unlock all fields". A per field badge beside the ASIN box is a follow up.
- Saved API keys are cleared when the server address changes (#3944, #4082). Changing the BookOrbit or Audiobookshelf base URL without entering a new key now clears the saved key instead of keeping it for the new address, so enter a key again after moving to a different server.
- Click a card to select it on the Authors and Books grids (#3960). Once one card is ticked, clicking an author card's picture and name, or a book's cover, adds or removes it instead of opening it, the same as book cards on the author page. Enter and Space do the same for a focused card. With nothing selected, cards open as before. Thanks to flaevers for the request.
- The General settings tab is now four tabs, each with a one line description (#3990). General was one long scroll. It now holds only Appearance and Security. File Naming (import mode, content checks, drop folders, import source folders, the metadata.opf sidecar and the three naming templates) is its own tab under Library. Storage (the download and library folders, the database check, Scan Library, Reorganize Library and the Default library location pointer) is a tab under Library too. Schedules (reject words, preferred language and the search, Hardcover sync, library scan, release discovery and series check intervals) sits under System. Every setting keeps its key, its auto save toast and its current value line. Links to a setting by key, such as
/settings?tab=general#import.mode, still land on the field, and Settings search now points at the new tabs. The setup checklist storage warning opens Storage. A link that names?tab=generalwith no setting key still opens General. - Settings that save on change now confirm it with a message (#3991). Import Mode, the interval selects, the toggles and the other settings that save the moment you change them used to do it silently, so you had to reload the page to see whether a change had stuck. Each one now shows a short message such as "Import Mode set to External", and a red "Couldn't save" message when the save fails. Fields with their own Save button keep their Saving, Saved and Error button. The messages stack, up to five at a time, instead of replacing each other, and a failed save puts the control back on the saved value.
- Queue chips for held, handed off and needs attention rows (#3992). A download held for pair gating or handed off to an external import tool counted as Active even though nothing was happening to it, and a blocked import looked like any other failure. The Queue now has Downloading, Importing, Held, Handed off and Needs attention chips next to All, Active and Failed, each with a count, and a chip with nothing in it stays hidden. The older
?view=activeand?view=failedlinks still work. - Status colours come from one place (#3994, #4116). Success, warning, danger, info, progress and caution colours, the green accent on primary buttons and focus rings, the blue of links, and the white text on solid fills are now named colour variables with light and dark values in the web UI's stylesheet, instead of amber, red, emerald, blue, orange and sky classes repeated across about 100 files. Colours are the same or very close, with a few small visible differences: alert and banner tints are slightly stronger, one hover over them is a little darker, and chip text in the dark theme is a lighter shade for better contrast. The contrast test measures each pair in both themes and fails if one drops under the WCAG AA minimum. A new test fails when a raw colour class, an arbitrary colour value or a class built at run time is added outside a short list of category colours such as the ebook and audiobook badges, so an accent or theme change is a one file edit.
- Import rollback code is shared between the Audiobookshelf and Calibre importers (#4023). Internal cleanup only. Stored rollback records keep the exact same format, so runs recorded before this release still roll back.
- Imports stay inside the download folder (#4083). A book listed by the download client is now skipped when it sits behind a symlinked folder that resolves outside the download, and file copies refuse a source that is a symlink or not a regular file. Normal nested folders, and downloads you reach through your own link, import as before.
- Nightly backlog sweep can only add the needs-triage label (#4085). The scheduled sweep no longer has broad permission to edit issues, so text in an issue cannot steer it into changing titles, bodies or assignees.
- The telemetry dashboard caches its numbers for a minute (#4092). getbindery.dev/stats and
/api/statsnow share one computed snapshot for up to 60 seconds instead of rerunning every dashboard query on each page load, and visitors who arrive at the same moment share one computation. The figures can lag a new ping by up to a minute./stats.jsonand ping handling are unchanged.
Fixed
- Torrents that keep failing are now blocklisted, carefully (#4111, #4119). A torrent whose download link answers 404 or 410, or that never reaches your client, was retried every six hours for ever, because only usenet failures and stalls reached the blocklist. Bindery now counts those failures per release and blocklists a release after three in a row, at least an hour apart, but only while its indexer is otherwise serving and no other release from it failed, so a broken indexer never takes good releases down with it. A single failure is still just retried, a torrent you remove in your client yourself is never held against its release, and a client that is unreachable, a torrent your client reports as errored (usually a full disk) and an indexer 429 or server error never count against a release. When an indexer answers with a 429, a server error or a "disabled till" notice, Bindery leaves that indexer alone for a while instead of re-sending its releases and extending the ban. A dead release alone on a quiet indexer can still need a manual blocklist from the History page. Thanks to highlander-phill for the detailed report.
- Requests treat shared books like the book routes do (#4088). With multi user enforcement on, a requester or user who asks for a missing format of a book they cannot change, a shared book or one another account holds, now gets a 409 that says to ask an admin, instead of a message claiming the book is already in the library. Only a request an admin files for them, or one already pending, stays pending, and even then a requester's auto approval no longer adds the format or starts a search. An admin approving by hand and installs with enforcement off are unchanged.
- Starting a library scan is now admin only (#4095). It matches the scan status and the rest of the library maintenance routes. The scan walks the whole library, so with logins enforced a non admin user no longer gets to trigger it. The Settings scan button and the adoption screen were already admin only, and installs without logins, plus API key requests, behave as before.
- Refreshing an author now also fills genres, and a language, that an existing book is missing (#3105, #4073). They come from the provider record that book already came from. A language is filled only for a book with no file yet, so the file's own language stays the source of truth for the library scan. A value already there, a locked field, a field with an Audiobookshelf conflict and a book from another provider are left alone, and a refresh never clears anything.
- Readable white text on amber, green, blue and red buttons and badges (#3084). The setup banner, the pending requests count, warning and rollback buttons, the selected filter pills, the Calendar's today marker, the duplicate keeper chip and several sky and red action buttons put white text on a fill as light as amber 500 or emerald 600, between 2.1 and 4.0:1 against the 4.5:1 that text needs, and red and sky buttons got lighter on hover. The amber, green and sky fills now use the 700 shade, and every one of them goes darker rather than lighter on hover, so white stays at 4.8:1 or better in both themes. A few of these buttons set no text colour and took the page's, so they now set white themselves. Thanks to francisrath for the report.
- Settings pointers name the right tab (#3990, #4113). The message Bindery returns when automatic grabbing is off now says to turn it on under Settings, Metadata Profiles, matching the in app text, and a few docs pages that still sent you to the General tab for file naming, log retention and auto grab now name the tab that holds each setting.
- Requests page tests no longer time out on a busy CI runner (#3606). The test's translation stub handed out a new function on every render, which made the page fetch its queue again and could put an approved row back on screen. The tests now use cheaper label queries and wait for the approve form to finish loading, and an approval of a single book no longer fetches the author defaults it never shows. Frontend tests also get a longer timeout as a backstop.
- ABS import tests no longer reach the network (#4051). About twenty tests asked the live audnex service for audiobook details, which took two minutes per lookup on CI runners with blocked egress and pushed the race job past its timeout. The package now refuses outside connections in tests, so it runs in about 20 seconds under the race detector.
- CI egress allowlist gaps (#3852, #4048). Dependency Review can reach api.deps.dev and the OpenSSF Scorecard API again, and the Container Scan, DAST and Helm Policy Tests jobs can pull Docker Hub layers that are now served from Docker's S3 bucket, so those checks stop failing on unrelated pull requests.
- Telemetry stats no longer log an error when a visitor leaves early (#4091). If someone closes the getbindery.dev/stats page, or a request to
/api/statstimes out, before the numbers are ready, the telemetry server now notes it at debug level instead of logging an error and writing a 500 nobody receives. Real database failures still log an error./api/statsnow logs those failures too, where it used to return a 500 silently.
Security
- Saved indexer, Prowlarr and download client credentials are cleared when the address changes (#4122). Editing an indexer or Prowlarr URL to a different server without typing a new API key now clears the saved key instead of keeping it for the new address. The same applies to a download client when its type, host, port, TLS setting or URL base changes: the saved API key, password and proxy password are cleared unless you enter new ones in the same save. Enter the credentials again after moving to a different server. A trailing slash, capital letters in the host or an explicit default port do not count as a move. The indexers synced from a Prowlarr connection keep their own key until the next sync.
- Saved Grimmory, Audiobookshelf, BookOrbit and Calibre plugin credentials are cleared when the server address changes (#4117). Changing the Grimmory server URL without entering a new API key or password now clears the saved ones instead of keeping them for the new address, so enter them again after moving to a different server. The same now holds when one of these addresses is changed or deleted through the Advanced settings screen or the generic settings API, the save tells you which credentials it cleared, a rejected save no longer changes the address, and the Grimmory test button no longer sends saved credentials to an address that has not been saved. Moving between spellings of the same address, such as a trailing slash, capital letters in the host or an explicit default port, keeps the saved credentials.
- Frontend tooling picks up the minimatch fix (GHSA-g3hv-75wg-m249, #4049). ESLint and typescript-eslint move to releases that use minimatch 11.0.9. These are build tools only; nothing in the shipped web bundle changes.