Glimshelf Guide

Get started with Glimshelf.

Try the included sample, connect a library, prepare a trip, or solve a problem. These instructions use the labels in the current public beta.

Updated September 9, 2026

Install the public beta ↗
On this page
  1. Start or connect
  2. Find and resume
  3. Read your way
  4. Download for later
  5. Organize and review
  6. Match and connect
  7. Privacy and backup
  8. Fix a connection
  9. Share feedback

01

Start or connect

Choose a way to begin.

Try the sample

Glimshelf includes Rainbow Potions, Episode 2 of Pepper & Carrot. Open it by choosing Try sample comics on the first screen. Five story pages and the original credits are included. Read them offline, resume where you stopped, and remove the book later from Manage Servers.

Pepper & Carrot is by David Revoy, shared under CC BY 4.0. See the episode source and full credits.

Add local books

Open Settings, Manage Servers, then choose Add Local Folder under Local Files. Pick a folder containing CBZ, CBR, CB7, PDF, or EPUB books. Select the folder itself, rather than an individual file. Glimshelf reads the books from that folder without uploading a copy.

Connect a server

  1. 1
    Choose the server type

    Open Settings, Manage Servers, then Add Server. Pick Komga, Kavita, or OPDS.

  2. 2
    Enter the base address

    Use the address that opens the server, including HTTPS and any path prefix.

  3. 3
    Check the connection

    Connection Doctor checks DNS, port, TLS, authentication, and API before the first catalog sync.

Free source limits

Free includes unlimited Komga, Kavita and OPDS servers and unlimited local files. Pro adds unlimited server downloads. Server credentials stay in Apple’s Keychain.

Add Server form with Kavita selected and the server address entered

Add Server form with Kavita selected and the server address entered

Add Server · Pick the type, enter the base addressOpen original

02

Find and resume

Continue from Home, or search the whole catalog.

Home and Library

  • Browse by series or book.At the top of Library, choose Series to group related books, or Books to see individual issues. If you have scrolled down the list, return to the top to find this switch.
  • Resume from Reading Now.It opens the saved page for the active reader profile.
  • Follow Up Next.It follows the series or reading list you are working through and disappears when there is no next book.
  • Arrange Home.Press and hold a normal shelf title until the row lifts, then drag and release it. Up Next stays first and cannot be moved.
  • Manage Home another way.Open the Home ⋯ menu, choose Manage Home, then tap Edit to reorder with drag handles. Press and hold a row for Show, Hide, and Move actions.
  • Search by title.Results keep series and books separate. One search covers every connected server and identifies its source on Free.

Series and book details

A series page groups its books. A book page shows its saved position, download control, and available actions.

Home showing A Fresh Start released in 2016 under Reading Now, followed by The Encounter, Pollution, and The Picnic under Up Next

Home showing A Fresh Start released in 2016 under Reading Now, followed by The Encounter, Pollution, and The Picnic under Up Next

Home · Continue A Fresh Start and see the next three episodesPepper & Carrot by David Revoy · CC BY 4.0Open original

03

Read your way

Set the controls for this book.

Tap the center of a comic or manga page to show the controls. Use the thumbnail strip to move farther through the book.

  • Comics and mangaChoose Paged, Double Page, or Webtoon. Set Left to Right or Right to Left, change scaling and background, crop margins, and fix a mis-paired spread.
  • EPUBUse the chapter list, follow links and footnotes, and change text appearance. Glimshelf restores the chapter, location, and appearance.
  • Continue to the next bookTurn on Continue to Next Book to move into the next title without returning to the library.
  • Bubble ZoomWith Pro, step between recognized speech balloons at readable size, then Copy, Speak or Translate the recognized text on your device.
  • Bookmarks and notesSave a page or EPUB location. Pro adds notes, the combined Bookmarks & Notes screen, and private iCloud sync.
Reader with the controls visible over a multi-panel comic page: thumbnail strip, page slider, and time remaining

Reader with the controls visible over a multi-panel comic page: thumbnail strip, page slider, and time remaining

Reader controls · Tap the page centerPepper & Carrot by David Revoy · CC BY 4.0Open original

04

Download for later

Check the files before you lose the network.

  1. 1
    Download a book

    Use the download action on a book. Pro also offers Download Series, auto-next, keep rules, and storage controls.

  2. 2
    Watch Downloads

    Active shows waiting, downloading, paused, and retrying work. Needs Attention keeps a failed transfer visible.

  3. 3
    Build a Trip Pack

    In Settings, open Offline Travel, then Trip Packs. Name it, choose Days, Items, or Storage, pick the books, and run Verify Offline Readiness.

  4. 4
    Reconnect normally

    Progress is saved on the device first. Queued Komga and Kavita updates resume when the source returns.

What the Free limit counts

Free keeps up to five downloaded server books at a time. Books in a Trip Pack count among those five. Local files do not count, and there is no local-file title limit. Pro removes the server-download cap.

Downloads with two paused Pepper and Carrot books under Active and one failed transfer under Needs Attention

Downloads with two paused Pepper and Carrot books under Active and one failed transfer under Needs Attention

Downloads · Active and Needs AttentionPepper & Carrot by David Revoy · CC BY 4.0Open original

05

Organize and review

Keep useful queues in one place.

Library health and alerts

  • Library HealthOpen Settings, Servers, Library Health, or use the Home ⋯ menu. Needs Attention links supported issues to their repair or review screen.
  • New Release AlertsOpen New Release Alerts, then add a server, series, or reading list. After a successful catalog or reading-list check, Glimshelf schedules alerts on device; iOS controls background timing.

Lists, orders, and collections

  • Reading ListsServer lists retain their order and can be pinned to Home.
  • Reading OrdersWith Pro, import a CBL or build a cross-series order. Unmatched steps stay visible, and Next Up returns to the correct entry.
  • Smart CollectionsWith Pro, define rules and match behavior; results update as the library changes.

Statistics

Free includes streaks and pages per day. Pro adds profile-specific reading time, sessions, pace, calendar-year statistics, yearly goals and a shareable Year in Review. Sharing happens only when requested.

Library Health listing a failed Pepper & Carrot download with a Review action, followed by iCloud sync issues that also offer review actions

Library Health listing a failed Pepper & Carrot download with a Review action, followed by iCloud sync issues that also offer review actions

Library Health · Open the action for each issuePepper & Carrot by David Revoy · CC BY 4.0Open original

06

Match and connect

Review every match before applying it.

  1. 1
    Open Match Online

    Use the ⋯ menu on the series or book you want to correct.

  2. 2
    Compare the record

    Check title, year, format, edition, and cover. A highly ranked result is still only a candidate.

  3. 3
    Apply or leave it unchanged

    Choose the intended record, or leave without applying when none is right. Compatible server permissions decide which edits can be written back.

Tracking and profiles

  • Set up optional trackingWith Pro, open a reader profile and connect AniList, MyAnimeList, or Metron. The account-setup screen shown below is still unlinked.
  • Link a seriesAfter connecting a tracking service, open Tracking on the series, choose that service, and enter its title ID. The example below shows the empty setup form.
  • Reader profilesProfiles keep progress, bookmarks, preferences, statistics, and optional service accounts separate. An unbound profile remains Local Only.
Match Online listing ranked Open Library candidates for Crime Does Not Pay, none applied yet

Match Online listing ranked Open Library candidates for Crime Does Not Pay, none applied yet

Review a metadata match before applying it.Open original

07

Privacy and backup

Know where the app sends data.

Glimshelf has no developer-operated account or library relay. The app connects directly to sources and optional services you choose. It does not automatically send the developer your library, reading history, notes, credentials, or diagnostics.

  • CredentialsServer credentials and service tokens stay in Keychain.
  • Profile protectionFree can require Face ID, Touch ID, or the device passcode before a profile opens.
  • Portable backupFree can export one backup through Files. Import previews a merge and does not erase newer data; keep the original until verified.
  • Private iCloud featuresWhen enabled, Pro uses your iCloud account for annotations, local-file progress, preferences, and statistics.
Compare Free and Pro
Back Up & Restore with Export Backup and Import Backup and what each one does

Back Up & Restore with Export Backup and Import Backup and what each one does

Back Up & RestoreOpen original

08

Fix a connection

Start with the first failed stage.

  • DNSCheck the host name, local DNS, VPN, and whether the address opens on this device.
  • PortCheck the port number, firewall, reverse proxy, or tunnel.
  • TLSCheck certificate validity, host-name coverage, and the certificate presented by the proxy.
  • AuthenticationRe-enter or recreate the credential on the server.
  • APIConfirm server type, supported version, base path, and account permissions.
Keep secrets out of reports

Share the failed stage and its message. Do not post passwords, API keys, private server addresses, or certificate fingerprints.

Connection Doctor reporting that sign-in failed and naming the credential to check

Connection Doctor reporting that sign-in failed and naming the credential to check

Connection Doctor · A failed stage names the fixOpen original

09

Share feedback

How did reading feel?

After a few pages, tell us what felt comfortable and what got in your way. A sentence or two is enough, even if everything worked. Email support@glimshelf.com; no diagnostic attachment is needed for general feedback.

A bug, confusing screen, wrong result, or missing convenience is useful beta feedback. Include what you tried, what you expected, what happened, and whether it repeats.

Join the Glimshelf conversation

Our Nimblor Discord community has public Glimshelf channels for questions, bug reports, ideas, and beta feedback. Include your app version, device, and iOS or iPadOS version when asking for help. Community posts are visible to other members; send diagnostic files and private details through email after reviewing them. Discord is optional, and replies may take time.

  1. 1
    Open Settings, Support

    Choose Report a Problem. Glimshelf prepares a message to support@glimshelf.com with an incident ID and diagnostic attachment.

  2. 2
    Review it before sending

    Check the recipient, your message, and the attachment. Nothing is sent automatically.

  3. 3
    Use the fallback when Mail is unavailable

    Choose Share Diagnostics, then send the file with an app you use for mail. Copy Support Email copies the address; the share sheet does not fill it in.

TestFlight feedback also works

Open Glimshelf in TestFlight and choose Send Beta Feedback, or use Share Beta Feedback from an iOS screenshot. Remove private filenames, titles, page images, account identifiers, server addresses, and credentials first.

You can also write to support@glimshelf.com.

Support showing Report a Problem, support at glimshelf dot com, and Export Privacy-Safe Diagnostics

Support showing Report a Problem, support at glimshelf dot com, and Export Privacy-Safe Diagnostics

Support · Report a problem or review diagnostics before sharingOpen original