Library & Downloads
The Library is the core dashboard of NeoQN, where you manage your saved novels, offline downloads, custom folders, and imported local documents.
Library Categories
NeoQN organizes your novels using categorised tabs, allowing you to easily manage large reading lists.
- System Categories: Default tabs include Reading, Completed, On Hold, Dropped, and Plan to Read.
- Custom Categories: You can add, rename, or hide categories to match your reading style by tapping the shapes icon in top right corner.
- Category Hiding: Hidden categories won't show up in the main sliding header but remain preserved in the database.
Under the hood, custom categories are stored in the Room database using unique state IDs (currentStateId >= 10). This architecture ensures custom categories do not conflict with the default ReadType system enums, preventing library membership states from resetting during syncs or updates.
Layout Configurations
Customize your library's visual presentation using three distinct layout modes via the top header bar:
- List Layout: A clean, single-column list displaying comprehensive details, including titles, chapter counts, and active download progress.
- Grid Layout: A compact three-column grid showing only the novel covers, maximizing screen space.
- Bento Layout: A premium Pinterest-style grid that uses dynamic grid span cells (a mix of 2-column wide cards and 1-column standard covers) for an aesthetically rich layout.
Search & Sorting
- Global Search: Filter books across all categories in real time using the glassmorphic search bar at the top of the Library screen.
- Floating Sort FAB: Tap the floating action button at the bottom-right of the screen to open the Sort Menu. You can sort novels by title (alphabetical), update times, last read date, and download progress.
Multi-Select & Bulk Actions
Tap the Double Tick (DoneAll) icon in the top header to activate Selection Mode. Once activated, select multiple novels to perform bulk management actions:
- Change Category: Move all selected novels to a different category (or custom category) simultaneously.
- Bulk Delete: Delete the database records and cached chapters/EPUB files for all selected novels at once.
- Bulk Migration: Migrate the selected novels from one provider source to another (e.g., if a source link goes down). NeoQN matches chapter counts and transfers bookmarks automatically.
Downloads Management
The Downloads tab (the first tab in the library list) acts as the control center for all background scraper operations.
- Sync Button: Triggers a global check for chapter updates across all bookmarked novels. It features a spinning animation while updates are active.
- Download Controls: Each active download card exposes buttons to pause, resume, re-download, or force-complete downloads.
Importing Local Books
NeoQN isn't limited to online scrapers; you can import your own offline documents.
- Import EPUB / PDF: Tap the Import button to select local EPUB or PDF files via the system file picker.
- Info: epub books get opened in the app native feature rich epub reader and pdf file in a seperate pdf viewer.
PDF to EPUB Converter
Convert static PDF layouts into highly readable reflowable EPUB format directly on your Android device.
- Background Processing: Conversions run using Android's
WorkManager(viaPdfToEpubWorker), ensuring the process completes in the background even if you exit the app. - Text Reflow (Auto-Fix): Merges hard line breaks inside PDFs into natural paragraphs to improve the reader layout.
- Exporting: Converted EPUBs are automatically imported into the library and can optionally be exported to your custom download directory.