Skip to content

Missing feature: Tags #136

Closed
Closed

Description

@scruffynerf

there is currently no freeform tagging at all, which can be used in a variety of ways, and is useful, and other organization systems/tools support.

Activity

  1. KodeStar commented on Oct 16, 2026

    @KodeStar
    Owner

    Thanks. Added in #145, along with the `/item` and export points you raised.

    Tags and genres

    • Every book now has freeform tags and genres. You can edit them on the admin book page (type a label and press Enter, or click a chip's x to remove it), and they show where each value came from, like the other fields.
    • Bulk edit can add or remove tags and genres across selected books. It merges into each book's own list rather than replacing it.
    • The admin book list filters by genre and tag (with counts), and search matches them too.
    • In the player, a book's page shows them as chips; tapping one opens Library > Books filtered by it. Library > Books also has Genre and Tag filters.

    Where they come from

    • Your own edits, which win over everything else and survive rescans.
    • An Audiobookshelf `metadata.json` in the book's folder. It's now read for tags, genres, subtitle, publisher, language and abridged, which were skipped before.
    • The files' genre tag. Several in one tag are split on `;`; commas are kept, because store categories like "Mystery, Thriller & Suspense" contain one. Placeholders like "Audiobook" or "Speech" are dropped.
    • A community match, which now also fills subtitle, language, publisher and abridged. There are no community genres yet.

    Existing books pick all this up on the first scan after you upgrade, without a full re-index.

    `/item` and the export

    • `/item`, and the list and search endpoints, now include `subtitle`, `publisher`, `language`, `abridged`, `genres` and `tags`. You can also filter with `GET /libraries/{id}/books?genre=...&tag=...`.
    • The library export gains the same fields. The default export stays free of folder paths and your tags, because it's the file people attach to public import issues on meta.audiosilo.app.
    • For your own scripts, Export with file paths and tags... (or `/admin/libraries/{id}/export?include=paths,tags`) adds each row's `paths` (every copy merged into that row) and its `tags`, so you can tie rows back to items. It downloads as `...-private.json`.

    It will be in the next release after v2.3.1.

  2. KodeStar commented on Oct 24, 2026

    @KodeStar
    Owner
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions