A small project to provide a web interface for reading comics and webnovels int he CBZ and CBR format.
Go to file
2025-05-06 19:45:16 -04:00
ajax Don't redirect getfoldercontents when requiring login. 2025-04-17 18:21:55 -04:00
comics Initial Commit 2023-08-18 12:50:45 -04:00
core Increase font size in toasts and make toast contents more consistent with title and body. 2025-04-13 14:31:52 -04:00
cron Set daysToKeep to 10 by default if no age specified on command line 2025-03-13 13:02:38 -04:00
css Clean up some styling and HTML layout 2024-03-10 13:31:03 -04:00
img Additions to implement manifest file for home screen app installation 2024-05-29 13:46:40 -04:00
install Add systemd service/timer files for clearing extracted issues. Update README to reflect updated codebase and service/timer instructions. 2025-03-13 13:25:52 -04:00
js Ensure expired sessions for ajax calls get immediately redirected. 2025-05-06 19:45:16 -04:00
thumbs Initial Commit 2023-08-18 12:50:45 -04:00
.gitignore Add single character name PHP files to the ignore list as they are only used for spot testing. 2024-01-07 16:50:54 -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
downloadcomic.php Switch makePathSafe to use native realpath() 2023-08-18 13:19:41 -04:00
functions.php Catch files with 'jpeg' extension when parsing comics for thumbnails 2025-03-13 12:49:22 -04:00
header.php Only start the session and create session variables when not running in CLI 2023-08-22 14:45:18 -04:00
htmlfooter.php Switch to jQuery/AJAX folder navigation 2023-08-21 20:55:09 -04:00
htmlheader.php Fix broken/outdated CSS from toastr as it seems to not be maintained anymore. 2025-04-13 13:35:23 -04:00
index.php Clean up some styling and HTML layout 2024-03-10 13:31:03 -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 Add systemd service/timer files for clearing extracted issues. Update README to reflect updated codebase and service/timer instructions. 2025-03-13 13:25:52 -04:00
sess.php Initial Commit 2023-08-18 12:50:45 -04:00
variables-dist.php Add ADULTMODE feature to hide adult themed comics 2023-11-14 08:25:05 -05: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 variables-dist.php file to variables.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