Skip to content
/ ugfzf Public

Fuzzy-find chords, tabs & more from the ultimate-guitar.com database

License

Notifications You must be signed in to change notification settings

Dook97/ugfzf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

                    _  _ __ _ / _|___/ _|
                   | || / _` |  _|_ /  _|
                    \_,_\__, |_| /__|_|
                        |___/

              ultimate-guitar.com fuzzy-finder
                by Dook97 (aka Jan Doskočil)

                        USER'S GUIDE

============================================================

                          [ABOUT]

This brief document serves as a guide to new users of the
ugfzf program.

ugfzf serves its user by allowing easy acces to the chords
and tabs found on ultimate-guitar.com from the comfort of
the terminal window, saving him the necessity of painful
interaction with modern web design.

                       [INSTALLATION]

You will need the following:
  * fzf in your PATH (github.com/junegunn/fzf)
  * dotnet runtime >=7.x
  * dotnet sdk >=7.x

Then simply clone this repo, cd into it and call

            dotnet build --configuration release

A binary will appear in "./ugfzf/bin/Release/net7.x"

                          [USAGE]

Using the program is very straightforward. Invoke it with

                     ugfzf [your query]

After it is done loading the required data, a selection
window will appear. You can type to narrow down your options
or change your selection with the up and down keys. Select
the item you like by hitting enter or select multiple by
pressing <Tab>. If you change your mind, you can also quit
without choosing anything - just hit Esc, Ctrl-c or Ctrl-d.

The contents of your selection will then be printed to
stdout.

You can also specify several command line options:

-t, --types       (Default: ct) Set allowed content types
                  for search.

possible values: [c]hords, [t]abs, [u]kulele, [b]ass,
                 [d]rums, [v]ideo

-m, --no-multi    (Default: false) Disallow multi-selection

--url             (Default: false) Disable interactive
                  selection and scrape provided URLs instead.

--help            Display help.

--version         Display version information.

                      [COMPATIBILITY]

The program was tested on Linux and Windows 10. Macs will
most probably do just fine, but you should really use an OS
for people with some notion of self-respect.

============================================================
github.com/Dook97/ugfzf

About

Fuzzy-find chords, tabs & more from the ultimate-guitar.com database

Resources

License

Stars

Watchers

Forks

Languages