song31/comix-server

PHP-based AirComix Server

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.

comix-server's Issues

Air Comic Viewer - File Not Found!

Hi,
I am trying to access the server comic and I get this message.
if I put in the 192.168.1.12:31257/Comics browser, I see the folders that have the comics:
Civil War The Incredible Hercules Vol1 StarWars Ultimate Marvel Zombies Spiderman Black Widow and the Marvel Girls

But in the Air Comic Viewer no way to configure it.

I have put this:
Type: AirComicServer
Address: 192.168.1.12:31257/Comics
Port: 31257
Password:
user ID

Docker image?

What about making a Docker image option for running? You could use the docker run -v flag to mount the comic folder to a specific path in the container.

sh: 0: Can't open install.sh

when i run sudo apt-get install python imagemagick libopencv-core2.3 libopencv-highgui2.3
and it make a mistake.
so i am try the apt-get install python imagemagick libopencv-core2.4 libopencv-highgui2.4

Then follow down to do ...
After running this command, （sh install.sh）the emergence of new problems

Can someone help me please...

Can only read .cbz but not .cbr

Hi,

I got the comix server up and running and have a connection with the client 'AirComix'. The app does see .cbr and .cbz files but i can only access .cbz files. Nothing happens when i click on a .cbr file.

Hope someone can help with this issue.
Erwin

error when installing install.sh

::::::::::::::::::::::::

1. Configure comix
   ::::::::::::::::::::::::
   ::::::::::::::::::::::::
2. Configure Apache
   ::::::::::::::::::::::::
   ERROR: File /usr/syno/apache/conf/httpd.conf-user does not exist.
   ERROR: File /usr/syno/apache/conf/httpd.conf does not exist.
   ::::::::::::::::::::::::
3. Configure PHP
   ::::::::::::::::::::::::
   ERROR: File /usr/syno/etc/php/user-setting.ini does not exist.
   ::::::::::::::::::::::::
4. Restart HTTPD
   ::::::::::::::::::::::::
   Wait 5 seconds...
   ./install.sh: line 112: /usr/syno/apache/bin/httpd: not found
   DiskStation>

i have a DS212+ running the latest version of DSM 5.0
hope this gets fixed or someone knows how to fix it.
cause the java version of air comic server isnt working either on synology but it works on windows.

Can not support symbolic link

hi
handler.php is not support symbolic link file.
check the path variable and allocate the real path if path is symbolilc link.

I clear to following code after path allocate in centos 7.

36 $path = $parent_path.$request_path;
37 debug("path: ".$path);
38 if (is_link($path)) {
39 $path = readlink($path);
40 debug("this is symbolic link. real path: ".$path);
41 }

thank you