- fixed some bugs in the library table when using with webroot
- added a language column to the database (and the library table)
- added 7zip support for cb7 files
- added user-dir startup option
- added Dockerfile for running in Docker
- added webroot option to configuration, useful for proxy pass configurations (issue #24)
- little unrar automation: after pip installation, run `paver libunrar' to automatically fetch compile and install the unrar library.
- now the scanning component ignores hidden (dot) files (issue #26)
- added new logo from blindpet (issue #27)
- upgraded to latest releases of various dependent packages
- refactoring database access in a Library object (see library branch)
- fulltext indexing and faceting support using whoosh (see whoosh branch)
- mobile optimized user interface based on angularjs and bootstrap. Designed to work with the new search api with facet support
All of these features are experimental and still unfinished.
ComicStreamer is a media server app for sharing a library of comic files via a simple REST API to client applications. It allows for searching for comics based on a rich set of metadata including fields like series name, title, publisher, story arcs, characters, and creator credits. Client applications may access comics by entire archive file, or by fetching pag e images, one at a time.
A web interface is available for searching and viewing comics files, and also for configuration, log viewing, and some control operations.
It's best used on libraries that have been tagged internally with tools like ComicTagger or ComicRack. However, even without tags, it will try to parse out some information from the filename (usually series, issue number, and publication year).
ComicStreamer is very early ALPHA stages, and may be very flakey, eating up memory and CPU cycles. In particular, with very large datasets, filters on the sub-lists (characters, credits, etc. ) can be slow.
If you have web development or graphic design skills, and would like to help out, please contact me at comictagger@gmail.com. In particular, ComicStreamer needs a new logo!
Chunky Comic Reader for iPad has added experimental ComicStreamer support. Pro upgrade required, but it's well worth it for the other features you get. Check it out! If you are comic reader developer (any platform), and would like to add CS support, please contact me if you need any special support or features.
- python 2.7
(via pip):
- tornado
- sqlalchemy >= 0.9
- watchdog
- python-dateutil
- pillow (PIL fork)
- configobj >= 5.0.5
- natsort
Optional:
- pybonjour (for automatic server discovery)
If you want to run it with docker you only need:
- Docker
For source, just unzip somewhere. For the binary packages, it's the usual drill for that platform. (No setup.py yet, sorry)
Settings, database, and logs are kept in the user folder:
- On Linux: "~/.ComicStreamer"
- On Mac OS: "~/Library/Application Support/ComicStreamer"
- On Windows: "%APPDATA%\ComicStreamer"
Or if you set --user-dir you can define where these things should be stored
From the source, just run "comicstreamer" in the base folder (on windows you may want to rename it comicstreamer.py).
For the binary builds, run from the installed app icon. There should be no taskbar/dock presence, but an icon should appear in the system tray (windows), or status menu (mac).
A web browser should automatically open to "http://localhost:32500". On your first run, use the "config" page to set the comic folders, and the "control" page to restart the server. It will start scanning, and all comics in the given folders and sub folders will be added to database.
Download the Dockerfile navigate to the download folder Build a Docker image with docker build -t yourname/comicstreamer . Run the image with docker run -d --name comicstreamer -p 32500:32500 -v /etc/comicstreamer:/config -v /path/to/your/comics:/data yourname/comicstreamer
If you want to customize the code just rename Dockerfile.CodeInVolume to Dockerfile, build it as described above (if you have to rebuild it use the --no-cache flag) Run the image with sudo docker run -d --name comicstreamer -p 32500:32500 -v /etc/comicstreamer:/config -v /path/to/your/comics:/data -v /path/to/your/code:/code yourname/comicstreamer
Some tips:
- Use "--help" option to list command-line options
- Use the "--reset" option (CLI) or control page "Rebuild Database" to wipe the database if you're having problems.