Skip to content

Commit 52bb4bf

Browse files
committed
Refactor: script: coalesce every distro known to the script into a single file with interactive or command line user selection.
Refactor: script: make script user friendlier.
1 parent bd62f45 commit 52bb4bf

6 files changed

Lines changed: 357 additions & 564 deletions

File tree

README.md

Lines changed: 57 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,77 @@
1-
# Rack Free Installer Scripts
2-
Scripts to easily install VCV Rack Free and its dependencies for a few different Linux distros.
1+
# Rack Free Installer Script
2+
A script to easily install VCV Rack Free and its dependencies for a few different Linux distros.
33

4-
The scripts check for dependencies; download and install them, if they are not present, and, finally, download and decompresses Rack Free to its default directory: "Rack2Free" in the user's home directory.
4+
The script checks for dependencies; downloads and install them, if they are not present, and, finally, downloads and decompresses Rack Free to its default directory: "Rack2Free" in the user's home directory.
55

6-
For example, if the current user is "myuser", Rack will be installed in
6+
For example, if the current user is "myuser", Rack Free will be installed in
77

88
```
99
/home/myuser/Rack2Free
1010
```
1111

12-
The scripts do nothing fancy: they will not install graphical Jack connection managers or install and enable Pipewire Jack: those are exercises left to the user.
12+
The script does nothing fancy: it will not install graphical Jack connection managers or install and enable Pipewire Jack: those are exercises left to the user.
1313

14-
## These scripts install VCV Rack Free version 2.6.3 by default.
14+
## The script installs VCV Rack Free version 2.6.3 by default.
1515

16-
### These scripts do not and cannot install the paid version of VCV Rack! If you need help installing that version, contact VCV Rack support!
16+
### The script does not and cannot install the paid version of VCV Rack! If you need help installing that version, contact VCV Rack support!
1717

1818
---
1919

20-
## Using the scripts
20+
## Using the script
2121

22-
Get the installer script for your preferred distro, put it in your home directory and run it from the terminal command line.
22+
Get the installer script; put it in your home directory, and run it from the terminal command line.
2323

24-
| Script name | Target Distribution | Package Manager |
25-
| ----------------------- | ------------------- | --------------- |
26-
| install_rack_manjaro.sh | Manjaro Linux | pacman |
27-
| install_rack_ubuntu.sh | Ubuntu | apt |
28-
| install_rack_mint.sh | Linux Mint | apt |
29-
| install_rack_fedora.sh | Fedora Linux | dnf |
24+
The script will ask you for the distribution you are using interactively; just type the number (or the Quit option to abort) and press the Enter key.
3025

31-
For example:
26+
The script is written to be compatible with the following distributions; but it may work for others using the same package manager:
3227

33-
To use the Manjaro script, download it; put it in your home directory; open a terminal, and run:
28+
| Distribution | Package Manager |
29+
| ------------- | --------------- |
30+
| Manjaro Linux | pacman |
31+
| Ubuntu | apt |
32+
| Linux Mint | apt |
33+
| Fedora Linux | dnf |
34+
35+
Distributions can also be selected using the command line by passing it the -d option followed by the UPPERCASE letter set for a known distribution; for example to install Rack Free in Ubuntu directly, run:
3436

3537
```
36-
./install_rack_manjaro.sh
38+
install_rack_free.sh -d U
3739
```
3840

39-
Usage for other distros is similar: just pick the right script.
41+
Known distributions and their set letters are the following:
42+
43+
| Distribution | Command line option |
44+
| ------------- | ------------------- |
45+
| Manjaro Linux | M |
46+
| Ubuntu | U |
47+
| Linux Mint | T |
48+
| Fedora Linux | F |
4049

41-
The scripts include a help screen, to display it, run:
50+
The script includes a help screen; to display it, run:
4251

4352
```
44-
<scriptname>.sh -h
53+
install_rack_free.sh -h
4554
```
4655

47-
Installation of JACK can be skipped so that the scripts are more useful to more distributions and to avoid overwriting existing installations, run:
56+
Installation of JACK can be skipped so that the script is more useful to more distributions and to avoid overwriting existing installations, run:
4857

4958
```
50-
<scriptname>.sh -j
59+
install_rack_free.sh -j
5160
```
5261

62+
Specific Rack Free versions can be installed using the -v option; for example to install the old Rack Free 2.5.2 version, run:
63+
64+
```
65+
install_rack_free.sh -v 2.5.2
66+
```
67+
68+
Keep in mind command line options are *case sensitive*.
69+
5370
---
5471

5572
## Requirements
5673

57-
The scripts require:
74+
The script requires:
5875

5976
- A reasonably recent version of your preferred distro.
6077

@@ -70,25 +87,25 @@ The scripts require:
7087

7188
## My favorite distro is not listed!
7289

73-
You can try using one of the available scripts that corresponds to the packaging system a particular distro uses, for example, the Ubuntu script might be compatible with Debian; check the table above to find out which package manager each script uses.
90+
You can try selecting an existing distribution that uses the same packaging system and manager your particular distro uses; for example, selecting Ubuntu might work with Debian; check the table above to find out which package manager the script acknowledges for each distribution.
7491

75-
If none of the scripts work for your chosen distribution, contributions for new scripts are welcome!
92+
If none of the options work for your chosen distribution, contributions for new distributions are welcome!
7693

7794
---
7895

79-
## Help! I can't download the scripts!
96+
## Help! I can't download the script!
8097

8198
You have a several options here.
8299

83100
Three common ones:
84101

85102
- Using your browser
86103

87-
- Download the .zip or tar.gz file named "Source code" from the "Releases" page in this repository and decompress it. This will net you all the scripts, so just use the appropriate one.
104+
- Download the .zip or tar.gz file named "Source code" from the "Releases" page in this repository and decompress it.
88105

89-
- You can download individual ones directly as well:
106+
- You can download the script directly as well using your browser as well:
90107

91-
- Click on the appropriate script for your distribution.
108+
- Click on the script.
92109

93110
- Click "Raw".
94111

@@ -99,11 +116,9 @@ Three common ones:
99116
- Type
100117

101118
```
102-
wget https://raw.githubusercontent.com/Bloodbat/RackInstallerScripts/refs/heads/main/install_rack_<yourdistro>.sh
119+
wget https://raw.githubusercontent.com/Bloodbat/RackInstallerScripts/refs/heads/main/install_rack_free.sh
103120
```
104121

105-
- Substitute the \<yourdistro\> part for the distro you are using after consulting the the table above.
106-
107122
- Press "Enter".
108123

109124
- Make sure you set the script to be executable after downloading!
@@ -114,35 +129,33 @@ Three common ones:
114129
- Run
115130

116131
```
117-
chmod +x <scriptname>.sh
132+
chmod +x install_rack_free.sh
118133
```
119134

120-
Where \<scriptname\> is your selected script.
121-
122-
## The default version of VCV Rack Free installed by the scripts is too old / too new!
135+
## The default version of VCV Rack Free installed by the script is too old / too new!
123136

124137
The default version is selected using the wisdom of the community in the forum and our personal experience.
125138

126-
Versions passing both tests will be the default whenever the scripts are updated.
139+
Versions passing both tests will be the default whenever the script is updated.
127140

128141
That said... if you want a different version, just pass it using the "-v" parameter sans the quotes.
129142

130-
For example, to install VCV Rack Free version 2.6.4 using the Linux Mint installer script, type:
143+
For example, to install VCV Rack Free version 2.6.4, type:
131144

132145
```
133-
install_rack_mint.sh -v 2.6.4
146+
install_rack_free.sh -v 2.6.4
134147
```
135148

136149
and press ENTER.
137150

138-
The scripts *do not* check for version correctness before trying to download a VCV Rack Free distribution, so... make sure you type an available version.
151+
The script *does not* check for version correctness before trying to download a VCV Rack Free distribution, so... make sure you type an available version.
139152

140-
## My distro is too old! The scripts are incompatible!
153+
## My distro is too old! The script is incompatible!
141154

142155
- Several options:
143156

144157
- You could... update your distro.
145158

146-
- You can also adjust the script.
159+
- You can also adjust the script, it is written to be clear and user friendly.
147160

148-
If you take this route, make sure you share it with us using a suitable name such as "install_rack_fedora_old.sh" or somesuch.
161+
If you take this route, please, make sure you share your changes with us!

install_rack_fedora.sh

Lines changed: 0 additions & 130 deletions
This file was deleted.

0 commit comments

Comments
 (0)