README.org

 1* Music
 2
 3This is just a repository of music I've transcribed and arranged (maybe
 4even written 👀) over the years. PDFs are not included so you'll have
 5to read on if you want to use any of the files here
 6
 7* ~.cho~
 8These are [[https://www.chordpro.org/][ChordPro]] files and must be "compiled" with the ~chordpro~
 9command or pasted into an online editor (if any exist).
10
11Check [[https://www.chordpro.org/chordpro/chordpro-installation/][the documentation]] for [[https://www.chordpro.org/chordpro/chordpro-install-on-windows/][Windows]] and [[https://www.chordpro.org/chordpro/chordpro-install-on-macos/][macOS]] installation guides; I
12have no idea what the best route is because I don't run either
13full-time. For Linux, I recommend using the version from your
14distribution's package manager. Arch Linux has it under ~chordpro~ and
15Debian has it under ~chordii~.
16
17Once installed, you can simply run ~chordpro file.cho~ and it will spit
18out a nicely styled PDF in the current working directory.
19
20** Configuration
21
22I have no idea how to configure the application on any platform other
23than Linux and that is accomplished by putting a JSON file in
24~~/.config/chordpro/chordpro.json~. The following is my config and it uses
25[[https://www.jetbrains.com/lp/mono/][JetBrains Mono]] because I find that to be a very readable typeface from
26further away. You'll of course need to edit all of the values so they
27fit your environment though.
28
29#+BEGIN_SRC json
30{
31    "pdf" : {
32        "fontdir" : ["/home/amolith/.fonts/JetBrains/"],
33        "fontconfig" : {
34            "mono" : {
35                ""           : "JetBrainsMono-Regular.ttf",
36                "bold"       : "JetBrainsMono-Bold.ttf",
37                "italic"     : "JetBrainsMono-Italic.ttf",
38                "bolditalic" : "JetBrainsMono-Bold-Italic.ttf",
39            },
40        },
41        "chorus" : {
42            "bar" : {"width"  :  1,},
43        },
44        "fonts" : {
45            "title" : { "description" : "mono bold 23", },
46            "chord" : { "description" : "mono bold 13", },
47            "text" : { "description" : "mono 13", },
48            "comment" : { "description" : "mono 13", },
49        },
50    },
51}
52#+END_SRC
53
54* ~.ly~
55
56These are [[https://lilypond.org/][LilyPond]] files! Haven't gotten into LilyPond much yet but I
57know Emacs ships with a LilyPond mode built in so I will likely use
58that.