animapper

Animapper

A tui tool to ease contributions to Anime-Lists data.

Display available data from AniDB and TVDB side by side with hyperlinks for easy confirmation. Grabs unmapped series from anime-list-todo.xml.

Largely a work in progress and an excuse to learn Go. I just hacked together something for my own purposes.
If anyone else actually needs/wants to use this, let me know and perhaps I'll improve it for public use.
Of course, any suggestions of features or contributions from people who know Go better are welcome.

This repository is on Codeberg, and may be mirrored to Github.

Installation

Developers can use the standard go tooling to compile from source. go install should also work in theory.
You will need to provide your own TVDB Bearer Token (as TVDB_TOKEN env var) for now. I haven't worked out an elegant Auth solution yet.

git clone https://codeberg.org/jack-mil/animapper.git
cd animapper
go build
./animapper

Only tested and developed on Linux with the Kitty terminal emulator. Terminal features (especially images) may not work on other platforms.

Ideas for future features

• AniDB API is horrible to work with, but could add info from AniList instead
  • AniDB id to AniList id could come from this project
• I have tested some code to display series images (Kitty Graphics Protocol). This would really help identifying mappings.
  • Can't easily get AniDB images, would need to use AniList posters instead
• Smarter database storage (sqllite3?) and caching of api requests and images.
  • This would also improve jumping around the entire data set, and keeping track of what has/hasn't been mapped.

About

Thanks to these resources and projects for reference

• bubbletea framework
• TVDB v4 API
• xmlquery library
• gh-dash (as a good bubbletea app example)

License

This application and source code is available under the terms of the GPL 3.0 License only (GPL-3.0-only). See COPYING.
Third-party components are used under their respective licenses; see the THIRD_PARTY_LICENSES.csv file for details

© Copyright 2026, jack-mil and the animapper project contributors