Skip to content

Self-hosted self-contained tracker of episodes, artists, and authors

License

Notifications You must be signed in to change notification settings

cloudcloud/episodical

Repository files navigation

Episodical

A self-contained full web application to manage and track Episodical, Artistic, and Document based entities.

Usage

There are 4 configuration requirements for Episodical, provided via environment variables.

  • HOSTNAME defines the hostname the service is made available under.
  • PORT is the local port that Episodical will listen on for requests.
  • DATA_FILE contains the full path filename of where the sqlite3 database will be stored.
  • DATA_PASSPHRASE is the private phrase used to encrypt the sqlite3 content.

The provided docker-compose.yml file can be used to bring up the service (with the predefined defaults of the above configuration), to run the docker containerised version.

Releases of the binary can also be found on the releases page for the specific version requested (and the operating system + architecture combination).

Integrations

There are several integrations available to utilise within Episodical to bring additional metadata for the different Episodical data types. Each of these integrations have their own configurations, which are each able to be configured from within the UI once Episodical is running. The configuration data for these is then stored within the encrypted sqlite3 database.

Building

To build from source, make install will do everything that's necessary.

For a relatively quick development cycle, the following command works well:

make clean install && HOSTNAME=localhost PORT=8088 DATA_FILE=/var/episodical/episodical.db DATA_PASSPHRASE=no ./episodical