Gitar

程序员吉他手的命令行工具。

Gitar? 你 git 得到它了吗？

下载和安装

注意：您需要在计算机上安装 Rust 才能使用此工具。如果没有，您可以访问 https://rustup.rs/ 安装它。

$ git clone https://github.com/thfm/gitar.git
$ cd gitar
$ cargo install --path . --force

有关音符输入的说明

音符输入功能在各个命令之间是通用的；因此，为了方便，这里只说明一次。

输入音符时，您只需提供名称，但也可以选择指定一个八度数（在需要的情况下）

• 音符名称必须是以下之一（区分大小写）：C，Db，D，Eb，E，F，Gb，G，Ab，A，Bb，B

• 八度数是任何正整数

有效的音符输入示例有 C，F，Ab0 和 B10。

无效的音符输入示例有 D#3 和 A-10。

命令用法

find

find 命令用于查找音符在不同品格位置。例如，

$ gitar find E4

生成如下所示的品格图

5 occurences:
-----∗ 0
││││││ 1
││││││ 2
││││││ 3
││││││ 4
││││∗│ 5
││││││ 6
││││││ 7
││││││ 8
│││∗││ 9
││││││ 10
││││││ 11
││││││ 12
││││││ 13
││∗│││ 14
││││││ 15
││││││ 16
││││││ 17
││││││ 18
│∗││││ 19

每个品格位置用 ∗ 表示，旁边的数字表示品格号。

如果没有找到指定的音符，输出将说明这种情况

$ gitar find Bb20
No occurences.

调整 tuning

如果您想在非标准调音中查找某个音符的位置怎么办？只需指定 tuning 选项的空弦音符值即可

$ gitar find D2 --tuning D2 A2 D3 G3 B3 E4
1 occurence:
∗----- 0

您实际上不必输入六个值；实际上，您可以输入任意数量的音符，程序将构建相应数量的弦的吉他。这意味着您也可以使用 find 查找贝斯吉他的位置，如下所示

$ gitar find Gb1 --tuning E1 A1 D2 G2
1 occurence:
∗│││ 2

添加 capo

您可以通过指定 capo 选项之后要放置品格来添加 capo

$ gitar find F2 --capo 1
∗----- 0

请注意，品格编号将改变，以将 capo 视为琴枕。

更改琴弦数量

最后，你可能遇到这样的情况，即 find 的输出与你预期的不同。以下是一个例子

$ gitar find E6

此输出为 No occurences，这对于 大多数 吉他来说是正确的，除非是24弦或更多弦（或具有 不同的调音）。如果这个例外适用，你可以使用 frets 选项

$ gitar find E6 --frets 24
1 occurence:
│││││∗ 24

此选项在你想要模拟弦数少于默认值的吉他时也非常有用（在这个程序中，默认值是21弦）

$ gitar find F4 -f 18
4 occurences:
│││││∗ 1
││││││ 2
││││││ 3
││││││ 4
││││││ 5
││││∗│ 6
││││││ 7
││││││ 8
││││││ 9
│││∗││ 10
││││││ 11
││││││ 12
││││││ 13
││││││ 14
││∗│││ 15