A small project to provide a web interface for reading comics and webnovels int he CBZ and CBR format.
Go to file
2026-02-16 13:28:35 -05:00
ajax Add a closecomic callback to clear out the comfile session variable when a shown comic is closed 2026-02-16 12:59:27 -05:00
comics Initial Commit 2023-08-18 12:50:45 -04:00
core Preparing for possible switch to different lightbox plugin 2026-02-16 10:05:15 -05:00
cron Set daysToKeep to 10 by default if no age specified on command line 2025-03-13 13:02:38 -04:00
css Cleanup where styles, css, and js files are referenced 2026-02-15 19:51:13 -05:00
img Additions to implement manifest file for home screen app installation 2024-05-29 13:46:40 -04:00
install Fix improper reference to clearextracts cron PHP job file 2026-02-16 13:28:35 -05:00
js Add a closecomic callback to clear out the comfile session variable when a shown comic is closed 2026-02-16 12:59:27 -05:00
thumbs Initial Commit 2023-08-18 12:50:45 -04:00
.gitignore Rename variables.php to config.php 2026-02-15 20:24:46 -05:00
.htaccess Initial Commit 2023-08-18 12:50:45 -04:00
authfunctions.php Make sure all ajax calls properly redirect to login page when required 2024-10-17 10:55:21 -04:00
config-dist.php Rename variables.php to config.php 2026-02-15 20:24:46 -05:00
downloadcomic.php Switch makePathSafe to use native realpath() 2023-08-18 13:19:41 -04:00
functions.php Increase thumbnail size by 50% 2025-05-07 15:14:04 -04:00
header.php Rename variables.php to config.php 2026-02-15 20:24:46 -05:00
htmlfooter.php Preparing for possible switch to different lightbox plugin 2026-02-16 10:05:15 -05:00
htmlheader.php Preparing for possible switch to different lightbox plugin 2026-02-16 10:05:15 -05:00
index.php Begin adding additional sort order for most recently read comics 2025-09-29 09:36:00 -04:00
logout.php Initial Commit 2023-08-18 12:50:45 -04:00
manifest.json Fix the scope path for the main app 2024-08-14 11:22:30 -04:00
README.md Fix the readme to reference the renamed config 2026-02-15 20:32:16 -05:00
sess.php Initial Commit 2023-08-18 12:50:45 -04:00

Comics Viewer

This small project provides a web based viewer for comics in the CBZ and CBR formats. Comic archive files are parsed and extracted dynamically while browsing and viewing. Thumbnails are created for both series and issues the first time a folder is accessed.

This project requires

  • PHP ImageMagick
  • PHP RAR (PECL)
    • Unfortunately RAR 4.2.0 has not been updated for PHP 8/8.2 (as of 2025-03-13). There is a fix available. Just replace the files in the version from PECL/Github with the ones in this.

Don't forget to:

  • Make sure the web server can read the folder than contains your comic book/novel archives
  • Create a MySQL/MariaDB database for the app with privileges granted to a user
  • Import the install/initial_db_mysql.sql database structure
  • Change the ownership of the comics/ and thumbs/ folders to the web server user
  • Copy the config-dist.php file to config.php and edit that file appropriately
  • Set up the cron job for things in cron/. If installing on a systemd OS see services below.

Services

If installing on an OS that uses systemd there are service and timer files available to run the periodic jobs. They can be installed like so:

  • Edit the script path to the appropriate installation location in the service file(s)
  • Copy the service/timer files to the system:
    • sudo cp install/clearextracts.* /etc/systemd/system/
    • sudo systemctl daemon-reload
  • Start the timer:
    • sudo systemctl start clearextracts.timer
  • Enable the timer:
    • sudo systemctl enable clearextracts.timer