https://github.com/agourlay/ruxguitar
Guitar Pro tablature player.
https://github.com/agourlay/ruxguitar
guitar guitar-tablature guitar-tabs guitarpro midi music tablature tabs
Last synced: 6 months ago
JSON representation
Guitar Pro tablature player.
- Host: GitHub
- URL: https://github.com/agourlay/ruxguitar
- Owner: agourlay
- License: apache-2.0
- Created: 2024-03-18T19:40:18.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-05-04T19:10:21.000Z (7 months ago)
- Last Synced: 2025-05-12T01:13:52.272Z (7 months ago)
- Topics: guitar, guitar-tablature, guitar-tabs, guitarpro, midi, music, tablature, tabs
- Language: Rust
- Homepage:
- Size: 6.67 MB
- Stars: 179
- Watchers: 4
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ruxguitar
[](https://github.com/agourlay/ruxguitar/actions/workflows/ci.yml)
[](https://crates.io/crates/ruxguitar)
A guitar pro tablature player.
The design of the application is described in details in the blog article "[Playing guitar tablatures in Rust](https://agourlay.github.io/ruxguitar-tablature-player/)".
## Limitations
- supports only gp5 & gp4 files
## Usage
```bash
./ruxguitar --help
Guitar pro tablature player
Usage: ruxguitar [OPTIONS]
Options:
--sound-font-file Optional path to a sound font file
--tab-file-path Optional path to tab file to by-pass the file picker
--no-antialiasing Disable antialiasing
-h, --help Print help
-V, --version Print version
```
A basic soundfont is embedded in the binary for a plug and play experience, however it is possible to provide a larger soundfont file to get better sound quality.
For instance I like to use `FluidR3_GM.sf2` which is present on most systems and easy to find online ([here](https://musical-artifacts.com/artifacts/738) or [there](https://member.keymusician.com/Member/FluidR3_GM/index.html)).
```bash
./ruxguitar --sound-font-file /usr/share/sounds/sf2/FluidR3_GM.sf2
```
## FAQ
- **Where can I find guitar pro files?**
- You can find a lot of guitar pro files on the internet. For instance on [Ultimate Guitar](https://www.ultimate-guitar.com/).
- **Why is the sound quality so bad?**
- The default soundfont is very basic. You can provide a better soundfont file using the `--sound-font-file` option.
- **Which dependencies are needed to run the application?**
- Check the necessary dependencies for your system from the [CI configuration](https://github.com/agourlay/ruxguitar/blob/master/.github/workflows/ci.yml).
- **Why is the file picker not opening on Linux?**
- Install the `XDG Destop Portal` package for your [desktop environment](https://wiki.archlinux.org/title/XDG_Desktop_Portal#List_of_backends_and_interfaces).
- **Why are the strings no rendered on the tablature?**
- You might need to disable antialiasing using the `--no-antialiasing` option.
- **Does it run on Windows 7 or Windows 8?**
- Yes, the Windows binary is built with Rust 1.75 which supports Windows 7 and Windows 8.
- **Why is the sound not working on Linux?**
- You are most likely using `PulseAudio` which is not supported.
## Installation
### Releases
Using the provided binaries in https://github.com/agourlay/ruxguitar/releases
### Crates.io
Using Cargo via [crates.io](https://crates.io/crates/ruxguitar).
```bash
cargo install ruxguitar
```
### Build
Make sure to check the necessary dependencies for your system from the [CI configuration](https://github.com/agourlay/ruxguitar/blob/master/.github/workflows/ci.yml).
## Acknowledgements
This project is heavily inspired by the great [TuxGuitar](https://sourceforge.net/p/tuxguitar/code/HEAD/tree/trunk/) project.