FicHub / fichub.net

web frontend for generating ebooks from fanfic
https://fichub.net
GNU Affero General Public License v3.0
45 stars 2 forks source link

FicHub.net is a frontend for generating ebooks from web fiction (fanfic and web serials) based on pre-existing external metadata and content services.

This project is licensed under AGPL-3.0-or-later. See the LICENSE file for complete details.

Contact

There is an IRC channel ##fichub on Libera.Chat and a discord at https://discord.gg/sByBAhX

If you'd like to support iris the creator, they have a patreon: https://www.patreon.com/irides

Setup

There are several additional components needed that are not currently covered by requirements.txt if you want a fully functioning instance of FicHub, though several of these may be omitted:

python-oil:
    grab from https://github.com/FanFicDev/python-oil

typescript:
    used for frontend js

sass:
    used for frontend styling

alexandria api access:
    used to lookup fic metadata and fetch content

    copy authentications.ex.py to authentications.py and fill in credentials
    to self host, see https://github.com/FanFicDev/hermes

postgres:
    used to store all metadata

    If a new database is created for a new instance, the OIL_DB_DBNAME env
    variable likely needs updated in the run and dump_db scripts.

elasticsearch:
    used for search fallback when a fic is not found

calibre:
    used to generate mobi and pdf formats

See https://github.com/FicHub/infra-dev if you're interested in using Docker to run a dev instance.

Licensing

FicHub.net is a frontend for generating ebooks from web fiction (fanfic and web serials) based on pre-existing external metadata and content services. Copyright (C) 2020-2021 iris

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.