Faircamp on Windows
Get started on Windows
Tutorial Overview
This tutorial will guide you through installing faircamp, generating your first faircamp site, customizing it further through the use of manifests, and finally show you one (of many) ways to publish your site online.
Install faircamp
Download and run the Windows Installer (64-bit), then continue with the next step below.
Create your catalog folder
First, open your file explorer and
create an empty directory in which we'll put your audio files and other data for the website (the catalog directory). It's name and location can be freely chosen, but
for instance you could name it simply Catalog
and put it in your Documents
folder.
Add releases
Now you can fill the catalog directory with your audio material. Each release (single/album/episode/...) should have its own subdirectory (the release directory), into which you place the audio files (and optionally, cover image). You can also add further hierarchical organization by putting multiple releases in a containing folder (e.g. organizing by artist or by year) but this is optional and has no effect on the website later - faircamp will only group your audio material by release.
Note that you can always add more material later, so adding one or two release here will suffice for a first test. Add as many releases as you want, then move to the next step.
Run faircamp
Still in your file explorer, move to the directory that contains your catalog folder, so that you are ready to drag and drop the catalog folder itself (which we will do in a second).
Now open the start menu
and begin typing the words "Command Prompt". You won't need to type it out in full as Windows will likely suggest the application of that name already after the first
few letters - just type until you are offered the suggestion, then click on it. Inside the command prompt, type cd
(this stands for "Change directory"), then press Space
(this serves as a separator), and
now drag and drop your catalog folder from your file explorer to the command prompt window. The active prompt line in your command prompt should now display something like cd C:\Example\Your Catalog\
,
and you can confirm the command (and thereby change directory) by pressing Enter
.
Finally, to run faircamp inside your catalog folder (which we are now in), type faircamp.exe --preview
and press Enter
. Faircamp will now process your files,
generate your website, and directly open the result in your browser (the latter because we added the --preview
flag). Congratulations: You created your first faircamp site!
Feel free to play around with the result, then come back to the next steps for learning how to customize it.
Customize the catalog
Text coming soon!
Customize a release
Text coming soon!
Customize the theme
Text coming soon!
Next steps coming soon!
This guide is currently being written/extended, augmented with screenshots/gifs, etc. Please check back the next days. In the meanwhile, or in general, check out Meljoann's great faircamp introduction.