Skip to content
𝄝 Ukulele CLI Support
Ruby
Branch: master
Clone or download
Latest commit 84e6e4c Nov 25, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
lib
.gitignore
CHANGELOG.md
Gemfile
MIT-LICENSE.txt
README.md Release v1.0.1 Oct 9, 2018
Rakefile
uke.gemspec

README.md

uke gem [version]

Displays popular ukulele chords for the popular GCEA tuning like this:

$ uke-chords G B7 C Cm
           
             βšͺ                     
             ╒══╀══╀══╕  ╒══╀══╀══╕
     _____   β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚
    / ____|  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |  __   β”‚  ●  β”‚  ●  β”‚  ●  β”‚  ●
   | | |_ |  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |__| |  β”‚  β”‚  ●  β”‚  β”‚  β”‚  ●  β”‚
    \_____|  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
             β”‚  β”‚  β”‚  β”‚  ●  β”‚  β”‚  β”‚
             β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜  β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜
           
                
                                        βšͺ
                   ╒══╀══╀══╕  ╒══╀══╀══╕
    ____ ______    β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚
   |  _ \____  |   β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |_) |  / /    ●  β”‚  ●  ●  β”‚  β”‚  ●  β”‚
   |  _ <  / /     β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |_) |/ /      β”‚  ●  β”‚  β”‚  β”‚  ●  β”‚  β”‚
   |____//_/       β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
                   β”‚  β”‚  β”‚  β”‚  ●  β”‚  β”‚  β”‚
                   β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜  β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜
                
           
             βšͺ  βšͺ  βšͺ     βšͺ     βšͺ     βšͺ         
             ╒══╀══╀══╕  ╒══╀══╀══╕  ╒══╀══╀══╕
     _____   β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚
    / ____|  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |       β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚
   | |       β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |____   β”‚  β”‚  β”‚  ●  β”‚  β”‚  β”‚  ●  β”‚  β”‚  ●  ●
    \_____|  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
             β”‚  β”‚  β”‚  β”‚  β”‚  ●  β”‚  β”‚  β”‚  ●  β”‚  β”‚
             β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜  β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜  β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜
           
                     
                       βšͺ         
                       ╒══╀══╀══╕
     _____             β”‚  β”‚  β”‚  β”‚
    / ____|            β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |     _ __ ___    β”‚  β”‚  β”‚  β”‚
   | |    | '_ ` _ \   β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |____| | | | | |  β”‚  ●  ●  ●
    \_____|_| |_| |_|  β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
                       β”‚  β”‚  β”‚  β”‚
                       β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜

You can also get suggestions which fingers to use with the --style fingering option:

$ uke-chords --style fingering C

           	 β—―  β—―  β—―   	 β—―     β—―   	 β—―         
           	 ╒══╀══╀══╕	 ╒══╀══╀══╕	 ╒══╀══╀══╕
     _____ 	 β”‚  β”‚  β”‚  β”‚	 β”‚  β”‚  β”‚  β”‚	 β”‚  β”‚  β”‚  β”‚
    / ____|	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |     	 β”‚  β”‚  β”‚  β”‚	 β”‚  β”‚  β”‚  β”‚	 β”‚  β”‚  β”‚  β”‚
   | |     	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
   | |____ 	 β”‚  β”‚  β”‚ ➊	 β”‚  β”‚  β”‚ ➊	 β”‚  β”‚  ➊ ➊
    \_____|	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€	 β”œβ”€β”€β”Όβ”€β”€β”Όβ”€β”€β”€
           	 β”‚  β”‚  β”‚  β”‚	 β”‚  βž‹  β”‚  β”‚	 β”‚  βž‹  β”‚  β”‚
           	 β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜	 β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜	 β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜

Setup

Make sure that your computer has Ruby 2.0 or higher installed.

Then run

gem install uke

Usage

On the command-line, run uke-chords, followed by the chords you want to display (see the example at top).

Run uke-chords without any parameters for a list of included chords.

MIT License

Except for the chords, copyright (C) 2015 Jan Lelis http://janlelis.com. Released under the MIT license.

You can’t perform that action at this time.