3
0
Fork
You've already forked freetar
0
freetar - an alternative frontend to ultimate-guitar.com
  • HTML 42.8%
  • Python 30.5%
  • JavaScript 24.5%
  • Dockerfile 1.8%
  • Jinja 0.4%
2026年03月22日 12:10:15 +01:00
freetar add a speed indicator 2026年03月01日 09:26:25 +01:00
tests First commit 2023年04月01日 12:41:21 +02:00
.gitignore feat: docker compose 2026年01月29日 19:53:02 +01:00
docker-compose.yml Make Docker image file system read only 2026年02月22日 19:57:33 +01:00
Dockerfile Update docker base image 2026年01月29日 20:14:26 +01:00
LICENSE Initial commit 2023年04月01日 12:40:30 +02:00
pyproject.toml Bump to v0.18.0 2026年03月22日 12:10:15 +01:00
README.md Use uv instead of poetry 2026年02月23日 09:18:57 +01:00
uv.lock Bump to v0.18.0 2026年03月22日 12:10:15 +01:00

freetar - an open source alternative front-end to ultimate-guitar.com

This is like Invidious but only for Ultimate Guitar.

Instances

Features

  • no ads, popups, AI, blockchain. Just a simple design
  • search for tabs and view them
  • save your favorite chords as favs (everything is stored in session storage (not send to the server), no account needed)
  • dark mode
  • auto scroll
  • useful for printing chords
  • show chords

How to use it

After successful installation, there is an executable called freetar in the PATH. Execute it without parameters and it listens on 0.0.0.0:22000.

You can specify a custom listen host or port by setting one or both of the following environment variables:

  • FREETAR_HOST
  • FREETAR_PORT

PyPi
Package: https://pypi.org/project/freetar/ 

pip install freetar

Docker
Image: https://hub.docker.com/r/kmille2/freetar
Port: 22000

sudo docker pull kmille2/freetar
sudo docker run -p 127.0.0.1:22000:22000 kmille2/freetar

Or use Docker compose:

sudo docker compose up -d

Set a custom bind port with the environment variable FREETAR_PORT

You can also build and run the local repository instead of pulling from Docker Hub:

docker compose build
docker compose up -d

Dev environment

You need uv. Then:

uv run freetar/backend.py
vim freetar/*.py
Visit localhost:22000 in browser
# static files: freetar/static/*
# html templates: freetar/templates/*
uv run freetar

Future work

  • (削除) show chords (削除ここまで)
  • improve UX on mobile devices
  • on smartphones: prevent lock screen
  • (削除) share chords (qr code)? (削除ここまで) (done by #12 with export/import functionality)
  • save favs encrypted server side?
  • (削除) Browser Extension like Invidious Redirection (削除ここまで) (done)

Contributions

Feel free to contribute, but please create an issue before with a proposal of the feature. I don't want freetar to be bloated (neither UI nor functionality).