kikootwo
aefc9ef667
Add a paginated Admin Requests API and fully refactor the admin requests UI to support filtering, sorting, pagination, and URL state. - New API: src/app/api/admin/requests/route.ts implements paginated, searchable, filterable, and sortable request listing with proper relation includes and pagination metadata. - Frontend: RecentRequestsTable rewritten to fetch via SWR (authenticatedFetcher), read/write URL query params, debounce search, support status/user filters, sortable columns, page size selector, and full pagination UI; added loading/error states and toast feedback for actions. - Admin page updated to use Suspense and the new RecentRequestsTable (component now fetches its own data). - Settings: deprecated single download-client PUT route now maps updates into the new multi-client format (download_clients JSON), logs deprecation, and invalidates download client manager; settings GET now reads multi-client config for backward compatibility. - Processors: monitor-download and retry-failed-imports updated to use the download-client-manager and new PathMappingConfig shape for path mapping logic. - Minor API/schema updates: request-with-torrent schema extended (indexerId, infoUrl, protocol) and setup complete no longer writes legacy path keys. - Tests updated to reflect API and processor changes. This change centralizes request management on the server, modernizes the UI for large datasets, and migrates download client settings toward a multi-client configuration while keeping backward compatibility.
Audiobook automation for Plex and Audiobookshelf
Radarr/Sonarr + Overseerr for audiobooks, all in one
Features • Setup • Screenshots • Discord
What is this?
You run Plex or Audiobookshelf with audiobooks. You want more audiobooks. You search indexers, download torrents or NZBs, organize files, wait for your server to scan. ReadMeABook does all of that automatically.
Request a book → Prowlarr searches → qBittorrent or SABnzbd downloads → Files organized → Library imports. Done.
Also includes BookDate: AI recommendations with a Tinder-style swipe interface. Swipe right to request.
User friendly audible-backed searches, multi-file chapter merging, e-book sidecar support, OIDC OAuth, admin approval workflows, and more.
Features
- Plex or Audiobookshelf
- Torrents via qBittorrent
- Usenet via SABnzbd
- Prowlarr for indexer search (torrents + NZBs)
- BookDate: AI recommendations (OpenAI/Claude/Local) with swipe interface
- Chapter merging: Multi-file downloads → single M4B with chapters
- E-book sidecar: Optional EPUB/PDF downloads from Shadow Library
- Request approval: Admin approval workflow for multi-user setups
- Setup wizard: Step-by-step guided config with connection testing
Setup
Prerequisites: Docker, Plex or Audiobookshelf, qBittorrent or SABnzbd, Prowlarr
services:
readmeabook:
image: ghcr.io/kikootwo/readmeabook:latest
container_name: readmeabook
restart: unless-stopped
ports:
- "3030:3030"
volumes:
- ./config:/app/config
- ./cache:/app/cache
- ./downloads:/downloads # Your download client's path
- ./media:/media # Your audiobook library
- ./pgdata:/var/lib/postgresql/data
- ./redis:/var/lib/redis
environment:
PUID: 1000 # Optional: your user ID
PGID: 1000 # Optional: your group ID
PUBLIC_URL: "https://audiobooks.example.com" # Required for OAuth
docker compose up -d
Open http://localhost:3030 and follow the setup wizard.
Screenshots
Community
Join the Discord: https://discord.gg/kaw6jKbKts
Feature and fix Contributions are highly welcome. Documentation in documentation/ if you want to contribute. Discord is a great place to ask questions!
Support
If you find this project useful, consider supporting development via GitHub Sponsors
If you'd like to support but cannot sponsor, a simple star on the GitHub repo is also greatly appreciated!
AGPL v3 License