Skip to content

FicHub/fichub.net

Repository files navigation

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/>.