X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=d80d3c5cb7f64afa88bba49195ae1d950d610395;hb=5dd985cf7d5e2bb88b07fd43e7b4a4eda4647181;hp=01f7419dd7d5ff6e7f35dddffe2dba08411308c3;hpb=b2612f9dcd0a37f4ec22fcabe55390280e06daf2;p=fanfix.git diff --git a/README.md b/README.md index 01f7419..d80d3c5 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,11 @@ Fanfix is a small Java program that can download stories from some supported websites and render them offline. -(If you are interested in the recent changes, please check the [Changelog](changelog.md).) +(If you are interested in the recent changes, please check the [Changelog](changelog.md) -- note that starting from version 1.4.0, the changelog is checked at startup (unless the option is disabled)) -![Main GUI](screenshots/fanfix.png?raw=true "Main GUI") +TODO: new screenshots + TUI screenshots + +![Main GUI](screenshots/fanfix-1.3.2.png?raw=true "Main GUI") It will convert from a (supported) URL to an .epub file for stories or a .cbz file for comics (a few other output types are also available, like Plain Text, LaTeX, HTML...). @@ -60,7 +62,9 @@ The following arguments are also allowed: - ```--read [id] ([chapter number])```: read the given story denoted by ID from the library - ```--read-url [URL] ([chapter number])```: convert on the fly and read the story denoted by ID, without saving it - ```--list```: list the stories present in the library and their associated IDs -- ```--set-reader [reader type]```: set the reader type to CLI or LOCAL for this command (must be the first option) +- ```--set-reader [reader type]```: set the reader type to CLI, TUI or GUI for this command +- ```--server [port]```: start a story server on this port +- ```--remote [host] [port]```: contact this server instead of the usual library - ```--help```: display the available options ### Environment variables @@ -77,10 +81,15 @@ Some environment variables are recognized by the program: You can also import the java sources into, say, [Eclipse](https://eclipse.org/), and create a runnable JAR file from there. +There are some unit tests you can run, too: + +```./configure.sh && make build test run-test``` + ### Dependant libraries (included) - libs/nikiroo-utils-sources.jar: some shared utility functions I also use elsewhere - [libs/unbescape-sources.jar](https://github.com/unbescape/unbescape): a nice library to escape/unescape a lot of text formats; I only use it for HTML +- [libs/jexer-sources.jar](https://github.com/klamonte/jexer): a small library that offers TUI widgets Nothing else but Java 1.6+. @@ -93,7 +102,9 @@ Currently missing, but either in progress or planned: - [x] YiffStar - [ ] [Two Kinds](http://twokinds.keenspot.com/) - [ ] [Slightly damned](http://www.sdamned.com/) -- [ ] A GUI (work in progress) + - [ ] Others? Any ideas? + - [x] [e-Hentai](https://e-hentai.org/) requested +- [x] A GUI (work in progress) - [x] Make one - [x] Make it run when no args passed - [x] Fix the UI, it is ugly @@ -103,8 +114,22 @@ Currently missing, but either in progress or planned: - [x] Show a list of types - [x] ..in the menu - [x] ..as a screen view - - [ ] options screen + - [x] options screen - [ ] A TUI reader + - [x] Choose an output (Jexer) + - [x] Implement it from --set-reader to the actual window + - [x] List the stories + - [ ] Fix the UI layout + - [x] Status bar + - [ ] Real menus + - [x] Open a story in the reader and/or natively + - [ ] Update the screenshots +- [ ] Network support + - [x] A server that can send the stories + - [x] A network implementation of the Library + - [ ] Write access to the library (?) + - [ ] Access rights (?) + - [ ] More tests, especially with the GUI - [ ] Check if it can work on Android - [x] First checks: it should work, but with changes - [ ] Adapt work on images :( @@ -122,8 +147,8 @@ Currently missing, but either in progress or planned: - [x] in output classes (export) - [x] CLI usage of such - [x] GUI usage of such -- [ ] Version +- [x] Version - [x] Use a version number - [x] Show it in UI - - [ ] A check-update feature + - [x] A check-update feature