Skip to content
PHP-based AirComix Server
PHP Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
conf
INSTALL.md
README.md
handler.php
index.php
install.sh
uninstall.sh
welcome.php

README.md

comix-server

Comix-server is a PHP-based AirComix Server acting just as the Windows version. Originally it was written to run on the Synology NAS. However, it can run on any platforms where Apache HTTP Server runs, such as Ubuntu Linux or OS X.

Comix-server is only compatible with iOS AirComix app.

How to install

  • Installer now supports both DSM 5.x and 4.x.
  • Log in to the Synology DSM and make a shared folder, for example, named "manga". This directory will be your manga directory.
  • Enable SSH and Web Station.
  • Download comix-server-master.zip, unzip it, and copy install.sh and uninstall.sh to your manga directory.
  • Connect to your Synology server using SSH as root and go to the manga directory (/volume1/manga). The path might be different in your system. Modify MANGA_DIR in install.sh if the path is not /volume1/manga.
    DiskStation> cd /volume1/manga
    
  • Give the execution permission on install.sh.
    DiskStation> chmod 755 install.sh
    
  • Run install.sh.
    DiskStation> ./install.sh
    

For more information about installation, please refer to the INSTALL.md.

How to uninstall

  • Run uninstall.sh on the Synology shell.

Special thanks to "20eung" for providing the install & uninstall script.

How to run

Start Apache HTTP Server. Usually the Apache HTTP process automatically starts when the machine boots up.

How to use

  • Copy your comic collection to the manga directory.
  • Start the AirComix app on your iOS devices and add comix-server as an AirComix Server. Select the AirComix Server URL menu to fill in your comix-server information. Note that default port number is 31257.
  • Enjoy!

How to contribute

Bug reports and pull requests are always welcome.

FAQ

Q) Which Synology DSM versions are supported?
A) The install script was tested only on DSM 5.x and 4.x. However, comix-server itself is just a web application written in PHP so it should run on any platforms with HTTPD & PHP.

Q) Which file formats are supported?
A) Comix-server supports archive formats such as ZIP and CBZ. Also it supports most image formats such as JPG, GIF, PNG, and TIFF.

Q) Does comix-server support RAR or CBR format?
A) Depends. Your system needs PHP extension for RAR. On Linux, you can easily install it (see http://www.php.net/manual/en/rar.installation.php for more details), but on Synology DSM, it seems very hard to install it. Please let me know if you find a way!

Q) Do I need to uncompress ZIP or CBZ files?
A) No. Like Windows version, just put them in your manga directory. However, comix-server does not handle double-zipped files.

Q) Can I have multiple directories under my manga directory?
A) Yes. You can make any directory structure. One restriction is that image files can be only in a leaf directory, which does not have any child directory.

Q) How can I change the port number?
A) See conf/httpd.conf-comix.

Q) How can I change the manga directory?
A) See comments in handler.php. You need to modify handler.php, index.php, user-setting.ini, and httpd.conf-comix.

Q) Does comix-server support password protection?
A) Yes, using Apache's basic authentication mechanism. Refer to http://www.cs.duke.edu/csl/faqs/web/basic-auth to know how to configure it. Note that the user name must be AirComix (case sensitve) and .htaccess file should be in /var/services/web/comix where handler.php exists. If there is no htpasswd util in your system, you can create the password file on other machines and copy it to your system.

Q) I cannot see some files under the manga directory. What is the problem?
A) If you have a directory which contains image files as well as ZIP files, move image files (or ZIP files) to another directory. A single directory can have multiple image files or multiple ZIP files, but not both.

License

Comix-server is free software licensed under GNU GPLv3. Everyone is permitted to copy, modify, and redistribute it.

You can’t perform that action at this time.