tabscroll is a (Ruby-powered) guitar tab scroller on the terminal.
It supports forward and backwards auto-scrolling and currently reads a nice range of guitar tabs.
$ tabscroll my-guitar-tab.txt
Running on a small terminal
The help window on a big screen
tabscroll only works with textual guitar tabs, not chords with lyrics.
It attempts to read any kind of tab format (although it works better with tabs exported from Guitar Pro). For now it requires you to split each tab row with a blank line. For example, this would work:
E S S S S S S Q S S S S E S S S S S S E S S S S S S
--0--------0------0----L---0-1-|--0----------0h-1-0----------0h-1-|
--1----------0h-1-1----L-1-----|--1----1----------1----1----------|
------------------0----L-------|--2--2-----2------0--0-----0------|
-----0-2----------2----L-------|--3------3--------2------2--------|
--3------3--------3----L-------|----------------------------------|
-------------------------------|----------------------------------|
E S S S S S S E S S S S S S E S S S S S S E S S S S S S
--0----3---0-----5--3---0------0-|--L----------0h-1-0----------3p-1-|
--1----------1-3-0--------3p-0---|--1----1----------1----1----------|
--2--2---2-------0----0----------|--2--2-----2------0--0-----0------|
---------------------------------|--3------3--------2------2--------|
--0------------------------------|----------------------------------|
-----------------3------3--------|----------------------------------|
But this wouldn't:
--0--------0------0----L---0-1-|--0----------0h-1-0----------0h-1-|
--1----------0h-1-1----L-1-----|--1----1----------1----1----------|
------------------0----L-------|--2--2-----2------0--0-----0------|
-----0-2----------2----L-------|--3------3--------2------2--------|
--3------3--------3----L-------|----------------------------------|
-------------------------------|----------------------------------|
--0----3---0-----5--3---0------0-|--L----------0h-1-0----------3p-1-|
--1----------1-3-0--------3p-0---|--1----1----------1----1----------|
--2--2---2-------0----0----------|--2--2-----2------0--0-----0------|
---------------------------------|--3------3--------2------2--------|
--0------------------------------|----------------------------------|
-----------------3------3--------|----------------------------------|
So if something bad happens and the program crashes, edit the tab making sure to keep a consistent tab format (6 in 6 lines, or 5 in 5) each with a blank line inbetween.
At worse, please comment (add # at the start of) any line that's not the tab
(you know, author info, instructions, etc). Sorry for the inconvenience, I plan
to improve a lot the detection of tabs on the future.
Hi, I'm Alexandre Dantas! Thanks for having interest in this project. Please take the time to visit any of the links below.
tabscroll homepage: http://www.alexdantas.net/projects/tabscrolleu @ alexdantas.netFAQs
Unknown package
We found that tabscroll demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CISA’s 2025 draft SBOM guidance adds new fields like hashes, licenses, and tool metadata to make software inventories more actionable.
Security News
A clarification on our recent research investigating 60 malicious Ruby gems.
Security News
ESLint now supports parallel linting with a new --concurrency flag, delivering major speed gains and closing a 10-year-old feature request.