• Upload & read .cbz (ZIP-based), .cbt (TAR-based), or .cb7 (7-Zip-based) comics directly in the browser
• CB7 / 7-Zip support – full read support for 7-Zip archives, both unencrypted and AES-256 encrypted (including header-encrypted -mhe=on archives)
  • LZMA (v1) and LZMA2 decompression supported
  • CRC32 verification used for reliable password validation (works even with store-only/uncompressed archives where wrong passwords produce silent garbage)
• Watch folder support for bulk imports – drop CBZ/CBT/CB7 files into your watch folder and they're automatically imported
• Supports 8 Megapixel images at 512MB memory limits
  • (increase in bash script for higher Megapixels or remove the limitation if you don't care)
• Full support for password-protected/encrypted CBZ files (AES-256 via yeka/zip), CBT files (AES-256-CFB OpenSSL), and CB7 files (AES-256 via bodgit/sevenzip)
• Automatically tries all previously successful passwords when opening a new encrypted comic
• Persists discovered passwords securely (AES-encrypted on disk, key derived from your login password)
• Extracts ComicInfo.xml metadata (title, series, number, writer, inker, tags, story arc, etc.) from CBZ, CBT, and CB7 archives
• Automatic folder organization: Library/Artist/StoryArc/Comic.cbz
• Manual reorganization via UI if needed
• Powerful tagging system with custom colors and counts
• Filter comics by any combination of tags
• Responsive grid view with cached JPEG covers
• Full-screen web reader with:
  • Page pre-loading
  • Zoom / pan
  • Fit-to-width/height/page
  • Keyboard navigation (←→, A/D, +/-, Esc)
• Multi-user support:
  • Each user has their own completely isolated library and password vault
  • First registered user becomes admin
  • Admin can disable new registrations
  • Admin can delete any comic
• Single unified bbolt database – replaces scattered JSON files for better performance and reliability
• Easy comic deletion – quick remove comics from your library with a single click
• Shareable links – generate and share direct links to individual comics, with optional share-level password protection
• Pagination support – efficient browsing of large comic collections
• Collections – organize comics into custom collections for better library management
• No external dependencies – everything self-contained in a single binary
• Single static Go binary + file storage – easy to deploy

• Go 1.26.0+ (only needed to build)
• Or just download a pre-built binary from Releases (when available)

git clone https://codeberg.org/riomoo/gopherbook.git
cd gopherbook
go build -o gopherbook app/gopherbook/main.go
./gopherbook

Then open http://localhost:8080 in your browser.

git clone https://codeberg.org/riomoo/gopherbook.git
cd gopherbook
./scripts-bash/run-gb-container/run-podman.sh

or

git clone https://codeberg.org/riomoo/gopherbook.git
cd gopherbook
./scripts-bash/run-gb-container/run-docker.sh

Then open http://localhost:12010 in your browser.

1. On first run there are no users → registration is open
2. Create the first account → this user automatically becomes admin
3. Log in → start uploading CBZ/CBT/CB7 files

./library/username/                ← your comics (organized or Unorganized/)
./cache/covers/username/           ← generated cover thumbnails
./watch/username/                  ← watch folder for bulk imports (auto-scanned)
./data/gopherbook.db               ← unified bbolt database (users, comics, tags, passwords, collections)

Can be used to configure storage locations and server settings:

GOPHERBOOK_LIBRARY=$HOME/.config/gopherbook/library
GOPHERBOOK_CACHE=$HOME/.config/gopherbook/covers
GOPHERBOOK_ETC=$HOME/.config/gopherbook/etc
GOPHERBOOK_WATCH=$HOME/.config/gopherbook/watch
GBKPORT=8080                                           # Set the port the server listens on (default: 8080)

Gopherbook includes an automatic watch folder system that makes bulk importing comics effortless:

• Per-user watch folders: Each user gets their own watch folder at ./watch/[username]/
• Automatic scanning: The system checks for new CBZ/CBT/CB7 files every 10 seconds
• Smart debouncing: Waits 5 seconds after detecting files to ensure they're fully copied
• File validation: Checks that files aren't still being written before importing
• Duplicate handling: Automatically renames files if they already exist (adds _1, _2, etc.)
• Zero configuration: Just drop CBZ/CBT/CB7 files into your watch folder and they appear in your library

1. After logging in, your personal watch folder is at ./watch/[yourusername]/
2. Copy or move CBZ/CBT/CB7 files into this folder using any method:
   • Direct file copy/paste
   • SCP/SFTP upload
   • Network share mount
   • Automated scripts
3. Within ~15 seconds, files are automatically imported to your library
4. Files are moved (not copied) to preserve disk space
5. Check the API endpoint /api/watch-folder to see pending files

Example workflow:

# Bulk copy comics to your watch folder
cp ~/Downloads/*.cbz ./watch/myusername/
cp ~/Downloads/*.cbt ./watch/myusername/
cp ~/Downloads/*.cb7 ./watch/myusername/

# Wait ~15 seconds, then check your library in the web UI
# All comics will be imported and organized automatically

• When you upload or scan an encrypted CBZ/CBT/CB7 that has no known password yet, the server marks it as Encrypted = true.
• The first time you open it in the reader, a password prompt appears.
• If the password is correct, Gopherbook:
  • Stores the password (encrypted with a key derived from your login password)
  • Extracts ComicInfo.xml metadata
  • Auto-organizes the file into Artist/StoryArc folders
  • Updates tags and cover cache
• From then on the comic opens instantly, and that password is automatically tried on every future encrypted comic you upload (so whole collections that share one password "just work").

CB7 archives support two modes of encryption:

• Content encryption (default -p flag): file headers are readable but content is encrypted. Wrong passwords produce a decompression error.
• Header encryption (-mhe=on): the entire archive including the file list is encrypted. Gopherbook detects this automatically and prompts for a password before listing pages.

In both cases, Gopherbook validates passwords by extracting a file and verifying its CRC32 checksum against the value stored in the archive header, which correctly handles store-only (uncompressed) encrypted archives where wrong passwords otherwise produce silent garbage output.

• Passwords are stored encrypted on disk using AES-256-CFB with a key derived from your login password via SHA-256.
• Session cookie is HttpOnly, expires after 24 h.
• No external dependencies that phone home.
• Still: treat this as a personal/private server – do not expose it publicly without HTTPS/reverse-proxy auth.

upstream gopherbook {
        server 127.0.0.1:8080;
        #server 127.0.0.1:12010; #For Podman instead
        server [::1]:8080;
        #server [::1]:12010; #For Podman instead
}
server {
        listen 80;
        listen [::1]:80;
        server_name gopherbook.example.com;
        location / {
                proxy_pass http://gopherbook;
                proxy_set_header Host $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header X-Forwarded-Proto $scheme;
                # 1. Allow very large uploads (e.g. 500 MB – adjust as needed)
                client_max_body_size 500M;          # 0 = unlimited, but never do that on a public server

                # 2. Give the upload enough time (important for slow connections)
                client_body_timeout 5m;             # time to read the entire request body (default 60s)
                proxy_read_timeout 5m;              # if you're proxying to your Go app
                proxy_send_timeout 5m;

                # 3. Increase buffer sizes so Nginx doesn't spill everything to disk
                client_body_buffer_size 512k;       # default 8k/16k – too small for big uploads
                proxy_buffers 8 512k;
                proxy_buffer_size 256k;

                # 4. Recommended: put uploads in a temporary directory with plenty of space
                client_body_temp_path /var/lib/nginx/body 1 2;   # make sure this directory exists and is writable by nginx
        }
}

Pull requests are welcome! Especially:

• Better mobile reader experience
• Bulk tag editing
• Search box

Please open an issue first for bigger changes.

• Check the Wiki!
• GitHub: https://github.com/riomoo/gopherbook/wiki/Meet-Vinny
• GitGud: https://gitgud.io/riomoo/gopherbook/-/wikis/Meet-Vinny
• JesterDesigns: https://git.jester-designs.com/riomoo/gopherbook/wiki/Meet-Vinny

• yeka/zip – password-protected ZIP support in pure Go
• bodgit/sevenzip – 7-Zip archive support in pure Go
• kulaginds/lzma – LZMA (v1) decompressor for 7-Zip archives
• The ComicRack ComicInfo.xml standard
• Everyone who hoards comics ❤️

Enjoy your library!
– Happy reading with Gopherbook

• Codeberg Riomoo
• GitGud Riomoo
• Github Riomoo