Skip to content
forked from kmille/freetar

freetar - an alternative frontend to ultimate-guitar.com

License

Notifications You must be signed in to change notification settings

dann-merlin/freetar

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 successfull installation, there is an executable called freetar in the PATH. Execute it without parameters and it listens on 0.0.0.0:22000.

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

Dev environment

You need poetry. Then:

poetry install
vim freetar/*.py
poetry run python freetar/backend.py
Visit localhost:22000 in browser

# static files: freetar/static/*
# html templates: freetar/templates/*
poetry 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

About

freetar - an alternative frontend to ultimate-guitar.com

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 47.6%
  • Python 31.1%
  • JavaScript 19.5%
  • Dockerfile 1.3%
  • Jinja 0.5%