amuse.git

a·muse is a no-JavaScript frontend for The Movie Database. It is also a system that connects films with books which the former are based on, thanks to using data from Wikidata. Finally, a·muse is also a place to collect ideas which films, books, and series watch or read next, and which of those have already been watched or read.

Name

The name of the system is ‘a·muse.’ The name of the program, command, any package is ‘amuse.’

Both are pronounced the same–[æˈʔmjuːz].

It’s a play of words—‘amuse’ as a verb, and ‘a muse’ as a goddess.

Building

To build version 0.3.x, You need:

  • go>=1.11

  • resvg

  • cwebp

  • mk

Then, all You have to do is run mk, and—optionally—mk install

Configuration

a·muse can be configured with command line arguments or with configuration file. Example configuration file can be found in example.toml. The only mandatory field is TmdbApiKey

Contribute

Contributions are welcome either as patches (send patches to git@apiote.tk).

If You want to translate a·muse, translate strings in i18n/default.toml and send patch, or share the translated file in any other way. The translated file must be named tag.toml, where tag is the language tag of the translation. Translations don’t have to be full; a·muse falls back to default (en-GB) when strings are missing.

This project uses nvie’s branching model. Please request merges to develop branch.

Roadmap

Roadmap exists inside CHANGELOG.adoc.

Recommendations have been removed from the Roadmap. API has been postponed till the project is more stable.

Licence

amuse Copyright (C) 2019–2020 apiote

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

$ git clone https://git.apiote.xyz/git/amuse.git