X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=03f2ce60e521a91426135613cb4659e5531772b5;hb=b4dc6ab518ded2dd92e4cbb02ac615b1d57e8e6d;hp=f7ef8b0ac7e6e734048cfc8a55ab60c50be3ed0e;hpb=88c61acaefde66584074867bda371dbfbcd92ec2;p=nikiroo-utils.git diff --git a/README.md b/README.md index f7ef8b0..03f2ce6 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # Fanfix -Fanfix is a small Java program able to download stories from some supported websites and render them offline. +Fanfix is a small Java program that can download stories from some supported websites and render them offline. + +![Main GUI](screenshots/fanfix.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 or LaTeX). @@ -9,7 +11,8 @@ To help organize your stories, it can also work as a local library. In this mode, you can: - Import a story from its URL (or even another file) - Export a story to a file (.epub or .cbz) -- Display a story from the local library +- Display a story from the local library in text format in the console +- Display a story from the local library graphically **by calling a native program to handle it** (though Fanfix can automatically process it into HTML so any browser can open it) ## Supported websites @@ -34,18 +37,19 @@ We support a few file types for local story conversion (both as input and as out ## Supported platforms -Any platform with at lest Java 1.5 on it should be ok. +Any platform with at lest Java 1.6 on it should be ok. + +It has only been tested on Linux and Windows for now, but feel free to inform me if you try it on another system. -If you have any problems to compile it with a supported Java version (1.4 won't work, but you may try to cross-compile; 1.8 had been tested and works), please contact me. +If you have any problems to compile it with a supported Java version (1.5 won't work, but you may try to cross-compile; 1.6 and 1.8 have been tested and work), please contact me. ## Usage -You can start the program in CLI mode: +You can start the program in GUI mode (as in the screenshot on top): - ```java -jar fanfix.jar``` -__TODO__: offer a GUI mode (work in progress) -The following arguments are allowed: +The following arguments are also allowed: - ```--import [URL]```: import the story at URL into the local library - ```--export [id] [output_type] [target]```: export the story denoted by ID to the target file - ```--convert [URL] [output_type] [target] (+info)```: convert the story at URL into target, and force-add the .info and cover if +info is passed @@ -67,22 +71,38 @@ Some environment variables are recognized by the program: ```./configure.sh && make``` -You can also import the java sources into, say, [https://eclipse.org/](Eclipse), and create a runnable JAR file from there. +You can also import the java sources into, say, [Eclipse](https://eclipse.org/), and create a runnable JAR file from there. ### Dependant libraries (included) -- libs/nikiroo-utils-sources-0.9.2.jar: some shared utility functions I also use elsewhere -- [https://github.com/unbescape/unbescape](libs/unbescape-1.1.4-sources.jar): a nice library to escape/unescape a lot of text formats; I only use it for HTML +- 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 -Nothing else but Java 1.5+. +Nothing else but Java 1.6+. Note that calling ```make libs``` will export the libraries into the src/ directory. ## TODO Currently missing, but either in progress or planned: -- A GUI (work in progress) -- A binary JAR release (and thus, version 1) -- Some readers other than CLI (TUI, GUI) -- Check if it can work on Android -- French translation +- [ ] A GUI (work in progress) + - [x] Make one + - [x] Make it run when no args passed + - [x] Fix the UI, it is ugly + - [ ] Work on the UI thread is BAD + - [ ] Allow export + - [ ] Show a list of types + - [x] ..in the menu + - [ ] ..as a screen view + - options screen +- [ ] A TUI reader +- [ ] Check if it can work on Android +- [ ] Translations + - [x] i18n system in place + - [x] Make use of it + - [x] Use it for all user output (some WIP remains) + - [ ] French translation +- [ ] Allow lauching a custom application instead of Desktop.start ? + - [ ] Make a wrapper for firefox to create a new, empty profile ? +- [ ] Install a mechanism to handle stories import progress update +