Faircamp 2
Nine months of work. Over a hundred thousand lines of code revised, added or deleted. Version 2 is the biggest Faircamp release to date and brings Faircamp from the console to the desktop, introducing the new graphical site editor, a fundamentally overhauled architecture and dozens of bigger and smaller new features.
This release would not have been possible without the kind support of the netidee grant programme, who funded the majority of this work – thank you so much!
Finally, thank you to all supporters and the over 30 contributors to this release – your support made all the difference as well. <3
#
Automatic migration to 2.0
12
# Automatic migration to 2.0
-
+5089 / -946 / ×52May 27, 2026
-
+6 / -6 / ×2Jun 02, 2026
-
+5 / -2 / ×3Jun 06, 2026
-
+112 / -57 / ×6Jul 14, 2026
-
+4 / -2 / ×1Jul 15, 2026
-
+57 / -20 / ×1Jul 15, 2026
-
+21 / -2 / ×2Jul 15, 2026
-
+9 / -5 / ×1Jul 15, 2026
-
+20 / -25 / ×3Aug 29, 2026
-
+46 / -5 / ×5Aug 31, 2026
-
+41 / -4 / ×3Aug 31, 2026
-
+311 / -58 / ×6Sep 01, 2026
Faircamp can automatically migrate your site for use with 2.0 – it detects 1.x sites and opens a one-click wizard (desktop application) or suggests the needed command for migrating (CLI).
# Graphical desktop application
Faircamp 2.0 introduces a graphical desktop application for editing and building Faircamp sites! This new interface coexists with the command line interface – both can be used interchangeably, even in parallel.
Main editor window (light theme)
Main editor window (dark theme)
Contextual actions in the navigation allow adding, removing or opening things in the file browser
-
+1909 / -979 / ×45Jul 01, 2026
Builds can be cancelled (and recontinued) anytime
-
+1658 / -1383 / ×65May 02, 2026
Flat and tree navigation for different workflows
Tags derived from audio metadata are displayed as defaults in the respective setting fields
Toggleable log panel
-
+445 / -411 / ×37May 02, 2026
Interactive visual feedback is provided when adjusting theme settings
You can do preview builds with the theming widget enabled from the graphical editor
#
Accessibility of the desktop application
3
# Accessibility of the desktop application
-
+232 / -146 / ×10Apr 20, 2026
-
+28 / -10 / ×2Jun 22, 2026
-
+63 / -26 / ×9Jul 07, 2026
The desktop application is fully navigable by keyboard. All screens should provide the most important landmarks for effectively navigating the application with assistive technology. All non-decorative visual elements of the interface should provide textual descriptions. There was no specific accessibility auditing yet though, so any problem reports, feedback and concrete suggestions for improvements are very welcome!
#
Introducing the dedicated podcast layout
4
# Introducing the dedicated podcast layout
-
+156 / -165 / ×22Apr 14, 2026
-
+1367 / -647 / ×10May 13, 2026
-
+224 / -82 / ×12Sep 06, 2026
-
+4 / -5 / ×1Sep 06, 2026
Multitrack release pages now support two different presentation modes: The existing default album layout, and the new podcast layout. In the new podcast layout the track list includes synopsis texts, release dates, bigger track covers, differently formatted duration info and much wider spacing between tracks. Additionally its default ordering is reversed (newest tracks first), although this can be configured with the multitrack.order setting in both layouts now.
#
Serving original audio formats for streaming and download
1
# Serving original audio formats for streaming and download
-
+21648 / -11394 / ×191Feb 19, 2026
You can now use the "original" setting to serve your audio files to visitors in exactly the format that you supplied, both for streaming and/or download (or in other words, this setting bypasses transcoding).
#
Label mode is gone – long live label mode!
1
# Label mode is gone – long live label mode!
-
+474 / -534 / ×33Jun 19, 2026
Label model has so far been Faircamp's monolithic way to switch from a presentation mode tailored for a single artist to one that is tailored for multiple artists/projects. Among other things, label_mode would display artist names in release overviews, auto-create pages for "main artists" while allowing further configuration through the feature_support_artists and show_support_artists settings, and enable further invisible routines relating to the automatic naming of the site and how links would lead you back to to the homepage.
In 2.0, label mode's functionality has been reimplemented through different mechanisms and settings, all with the aim of making the new approach more intuitive, granular and flexible. There are many interconnected aspects to this, but to name three cornerstones of this, going from conceptually overarching to specific:
1) In 2.0 a Faircamp site can not only present an artist or label, it can also present a single release, or even just a single track. If there is only a single track on your site, Faircamp will automatically feature it directly on the homepage now. Likewise, if your site contains multiple releases and a single artist that is its sole author, Faircamp will automatically turn the site into an artist site by making the artist page the homepage. And whenever you want to manually intervene in this, the explicit homepage setting (for artists, catalogs, multitracks and tracks) lets you do just that.
2) Whether an artist page is generated or not now rests on a simple core logic: If you explicitly create a directory and manifest for the artist – which is anyhow required to provide even just a link or one-liner for the artist – it gets its own page. There are no other magic rules for this anymore, no complex automation settings to discover and grasp regarding when artist pages are generated and when they aren't.
3) The artist_attribution setting now allows you to discretely control whether artists should be shown alongside releases in overviews, independent of whether the site is an "artist" or "label" site, or something else entirely.
#
Introducing stand-alone tracks / "multitrack" is the new "release"
1
# Introducing stand-alone tracks / "multitrack" is the new "release"
-
+28087 / -15351 / ×288Mar 27, 2026
2.0 extends Faircamp's architecture, allowing for stand-alone tracks that do not need to be contained in a "release" anymore. As a track can now be a release in itself, what was formerly called "release" (something that contains tracks) is now called "multitrack".
Put another way: In 2.0 a single audio piece (a "single", an audiobook, etc.) is a "track" and it can stand on its own. When you have multiple tracks that belong together (tracks of an album, episodes of a podcast, etc.) you now wrap them into a "multitrack" (which corresponds to what was formerly called "release").
#
Introducing adaptive mode for themes
3
# Introducing adaptive mode for themes
-
+2733 / -2245 / ×32May 18, 2026
-
+21648 / -11394 / ×191Feb 19, 2026
-
+460 / -329 / ×11Jun 10, 2026
Previously you could set up your themes either as dark or light. 2.0 introduces a third mode: Adaptive theming. Configure both a dark and a light theme appearance at the same time (this also allows for different background images for each). When someone visits your page, their system preferences decide which theme they see – and they can also manually toggle between dark/light using a button in the footer. This mode is the new default. On migrated sites you can enable it through the theme.mode setting.
#
Support for multiple, labelled external download links
3
# Support for multiple, labelled external download links
-
+340 / -86 / ×24Mar 27, 2026
-
+179 / -86 / ×8Jun 11, 2026
-
+567 / -294 / ×47Apr 30, 2026
You can now specify multiple external download links for releases and tracks. Download links can optionally be labelled now.
#
Visibility settings and conditional browse/search navigation
5
# Visibility settings and conditional browse/search navigation
-
+1175 / -1699 / ×112Jul 02, 2026
-
+420 / -162 / ×54Jun 29, 2026
-
+734 / -528 / ×70Jun 29, 2026
-
+677 / -67 / ×54Apr 30, 2026
-
+719 / -78 / ×26Feb 28, 2026
The new, unified visibility setting expands the previous unlisted/not unlisted state into four distinct states: Featured (openly accessible and included in browse/search navigation), Public (openly accessible but excluded from browse/search navigation), Unlisted (don't publicly link to item) and Offline (do not include in site). When all entities on a faircamp site are non-featured, the browse/search navigation automatically disappears.
#
Non-streamable and no-audio tracks
1
# Non-streamable and no-audio tracks
-
+748 / -489 / ×38Jun 12, 2026
Tracks can now be explicitly set as non-streamable with the track.streamable setting or be created without an audio file to begin with (which can be added later too).
#
Extended podcast settings and full spec compliance
3
# Extended podcast settings and full spec compliance
-
+708 / -475 / ×41Apr 15, 2026
-
+6 / -6 / ×3Apr 16, 2026
-
+93 / -93 / ×18Apr 14, 2026
You can now configure podcast.categories for your podcast feed(s). Explicit content can be tagged through podcast.explicit and is now communicated in podcast feeds (itunes:explicit). By default, streams are marked non-explicit.
#
Universal Settings
1
# Universal Settings
-
+7503 / -5974 / ×164May 13, 2026
The new universal settings allow you to set certain options across all objects to which they apply. For instance, instead of separately specifying download formats for multitrack and track objects with multitrack.download_formats and track.download_formats you can now specify *.download_formats to do it in one declaration.
#
Tags
3
# Tags
-
+2184 / -799 / ×59Jun 28, 2026
-
+71 / -35 / ×1Jun 28, 2026
-
+16 / -10 / ×3Jul 16, 2026
The tags setting has been split up into a new, subtly different constellation of settings, which now allow fine-grained control over tag rewriting without having to specify all tags that should be rewritten. For an overview take a look at tags.mode.
#
New date/time metadata: released, published, updated
3
# New date/time metadata: released, published, updated
-
+638 / -241 / ×41Apr 21, 2026
-
+478 / -283 / ×47Jun 05, 2026
-
+1319 / -619 / ×44Jun 06, 2026
Faircamp now has three new date/time metadata fields: released (the date of release on the faircamp site or anywhere else), published (the date/time of first publication on the faircamp site) and updated (the date/time of the last update of the respective item on the faircamp site).
These three new settings replace the former date setting and now also apply to tracks (released) or even artists, catalogs and tracks as well (published/updated). At this point they are mostly used for feeds, but in upcoming versions will likely also be used more widely and visibly on the site itself.
#
New automatic and configurable homepage setting
6
# New automatic and configurable homepage setting
-
+94 / ×1Jun 29, 2026
-
+177 / -174 / ×46Apr 15, 2026
-
+21648 / -11394 / ×191Feb 19, 2026
-
+104 / -29 / ×3Jul 02, 2026
-
+153 / -1 / ×7Jun 01, 2026
-
+143 / -80 / ×5Jun 29, 2026
Any page can be the homepage now – artist, catalog, multitrack or track. Faircamp automatically picks your homepage based on your content if you don't explicitly configure it, for instance: If you only have one release, it will be directly on the homepage by default. The permalink-based URL of any object now redirects to the homepage when an item is set as the homepage.
#
Paycurtain without payment info
3
# Paycurtain without payment info
-
+176 / -151 / ×30Jun 24, 2026
-
+3 / -3 / ×3Jul 14, 2026
-
+5 / -5 / ×5Jul 14, 2026
When you have enabled a paycurtain but not provided payment info, the paycurtain is now rendered anyway, containing a generic default text instructing users to look for payment or donations links on the site.
#
Clean URLs are now opt-in
2
# Clean URLs are now opt-in
-
+10 / -6 / ×4Jun 19, 2026
-
+46 / -5 / ×5Aug 31, 2026
Faircamp now produces long-time-archiving-friendly builds, which are directly viewable from disk, out of the box. The site.clean_urls setting allows opting in to clean urls through a manifest setting now. Additionally, the --no-clean-urls flag allows overriding/disabling clean urls for (e.g.) the automatic creation of archivable builds in automated pipelines and backup routines.
#
Speed controls as track-level setting
1
# Speed controls as track-level setting
-
+166 / -103 / ×15Jun 18, 2026
Speed controls can now be enabled/disabled at the track level. The respective controls are rendered enabled/disabled in the player at runtime.
#
Revised and customizable track ordering
2
# Revised and customizable track ordering
-
+397 / -33 / ×25Jun 04, 2026
-
+1319 / -619 / ×44Jun 06, 2026
Track order is now heuristically determined: If there are track numbers on most tracks, they control ordering. If there are release dates on even more tracks, they control ordering instead. Etc. Beyond this, ordering can be customized for each release, supporting many different ordering options: multitrack.order
#
Expanded artist overrides
1
# Expanded artist overrides
-
+171 / -23 / ×23Jun 03, 2026
With the new defaults system you can override artists throughout the entire site (or for arbitrary subdirectories, etc.)
#
A completely overhauled command line interface
4
# A completely overhauled command line interface
-
+1351 / -708 / ×26Sep 14, 2026
-
+71 / -52 / ×5Sep 14, 2026
-
+2 / -2 / ×1Sep 15, 2026
-
+14 / -5 / ×2Sep 15, 2026
The command line interface has been cleaned up, improved and redesigned as a primarily command-based interface. For example: "faircamp" is now "faircamp build", "faircamp --preview" is now "faircamp preview", "faircamp --wipe-build" is now "faircamp clean build", etc. All prominent, accident-prone operations have been outfitted with safety confirmations, at the same time the new --non-interactive option allows disabling these prompts for use in fully automated scripts.
#
Hotlinking protection settings merged
1
# Hotlinking protection settings merged
-
+226 / -121 / ×18Jun 02, 2026
In 2.0 the previous freeze_downloads_urls and rotate_download_urls settings have been combined into a single url_seed setting.
#
Documentation reboot
12
# Documentation reboot
-
+6658 / -5872 / ×97May 08, 2026
-
+228 / -51 / ×12Jul 06, 2026
-
+33 / -8 / ×5Jul 03, 2026
-
+223 / -250 / ×16Jul 03, 2026
-
+4601 / -4488 / ×15Jul 06, 2026
-
+582 / -479 / ×17Jul 06, 2026
-
+21 / -6 / ×4Jun 02, 2026
-
+6 / -3 / ×1Jun 02, 2026
-
+124 / ×1May 08, 2026
-
+80 / -44 / ×9Jun 23, 2026
-
+11 / -3 / ×1Sep 03, 2026
-
+12 / -3 / ×4Sep 03, 2026
The documentation has been completely overhauled for 2.0. Among other things it now includes an in-page navigation and search functionality (keyboard shortcut: "s"), which also allows searching by multiple keywords at once (seperated by space). One of the more notable additions in content is a stand-alone podcast example. Starting with the Faircamp 1.7 to 2.0 transition, archived documentation for previous versions will now be provided alongside that of the latest version. In other words, the documentation for 1.7 is and will stay permanently available at https://faircamp.org/docs/1.7.0/ and this will also apply for future versions as they are succeeded by newer ones.
#
Releases, tracks and catalogs as external pages
1
# Releases, tracks and catalogs as external pages
-
+211 / -29 / ×31Apr 30, 2026
The external_page setting is now available for catalogs, releases and tracks as well, allowing you to "outsource" releases, tracks, or entire catalogs to external pages, while still having them be discoverable through your faircamp site.
#
Aliases and false aliases for artists
1
# Aliases and false aliases for artists
-
+40 / -1 / ×5Apr 15, 2026
Artist aliases are now split into aliases (different artist names that connect to one artist and are always shown – a new setting) and false aliases (different names rewritten to a single name, the former alias setting).
#
Site-wide links
1
# Site-wide links
-
+345 / -223 / ×21May 13, 2026
The new site.links setting enables site-wide links, rendered in the footer.
#
Simpler and shorter links syntax
2
# Simpler and shorter links syntax
-
+645 / -345 / ×13Jun 02, 2026
-
+1094 / -804 / ×59Apr 21, 2026
The manifest syntax for declaring links has been greatly simplified. rel-me linking is now supported through the site.metadata setting using link tags rather than through links directly.
# Image description setting changes/improvements
Image descriptions are now represented as separate manifest settings 1
-
+788 / -250 / ×44Apr 15, 2026
Image descriptions now support both inline and multiline values 1
-
+237 / -35 / ×18Jun 01, 2026
#
Feed and feed settings improvements
2
# Feed and feed settings improvements
-
+783 / -465 / ×73Apr 28, 2026
-
+1319 / -619 / ×44Jun 06, 2026
The "Generic RSS" feed is now called "Plain RSS", both for visitors on faircamp sites and in the respective setting. Furthermore the feeds setting now supports different, more versatile presets – textual feeds only, media feeds only, etc. Feeds now also make use of the newly introduced published and updated settings data.
#
Favicon setting changes
1
# Favicon setting changes
-
+71 / -221 / ×17Apr 21, 2026
Custom favicons must now be included through the site.assets and site.metadata setttings. The favicon setting itself has become a toggle to disable the native faircamp favicon: site.disable_favicon
#
Cover generators
1
# Cover generators
-
+218 / -91 / ×7Jun 16, 2026
You can now configure the cover generator used for procedural covers using the theme.cover_generator setting (most choices are currently somewhat similar and on the experimental side though). Generated covers are fully opaque now, and generated either in their configured dark or light variant – this is not tied to the theme anymore. More diverse, fancy and polished cover generators will probably be added at some point in the future.
#
New "Extras Label" and new default for extra downloads
2
# New "Extras Label" and new default for extra downloads
-
+7503 / -5974 / ×164May 13, 2026
-
+367 / -42 / ×47Apr 29, 2026
Additional downloads can now be labelled in a custom way using the extras_label setting. The default availability of extra downloads is now bundled+separate (instead of just bundled).
# Platform Integration/Link Previews based on Open Graph
Note: Content embeds are currently only configurable, but not yet implemented
The "opengraph" setting is now the "platform integration" setting and includes "content embeds" (timeline player embeds) 1
-
+559 / -174 / ×66Apr 10, 2026
Link previews (formerly "opengraph") are now enabled by default 1
-
+559 / -174 / ×66Apr 10, 2026
#
Theming widget refinements
1
# Theming widget refinements
-
+460 / -329 / ×11Jun 10, 2026
Faircamp's theming widget now temporarily stores your changes for each theme and for dark/light mode separately, meaning that you can experiment with and switch back and forth between different settings in dark/light mode and across pages that already have a different theme according to the settings in your manifest(s).
#
The catalog is gone – long live the site and its catalogs!
1
# The catalog is gone – long live the site and its catalogs!
-
+28087 / -15351 / ×288Mar 27, 2026
In 1.x everything revolved around the "catalog", which represented the entirety of your site, its global settings, as well as the homepage. In 2.0 this evolves in three ways:
Your faircamp site (in its entirety) is now simply called a "site", and with it, the catalog directory became the site directory. The main rationale behind this is 2.0's new flexibility: A Faircamp site can present arbitrary content now (right on the homepage), down to just a single track! "Catalog" would not describe this intended openness to different uses well anymore.
With catalog becoming site, the catalog.eno manifest became the site.eno manifest, and it now solely contains global settings – those that represent global metadata (title, url, etc.) and those that are inherited down to all items and pages on your site (for instance a global theme, or settings that should apply to all artist pages).
And that leaves one thing: Where did the catalog, as a homepage and overview of all releases, go? The answer depends on your usecase:
If you only present a single track, a single release, or multiple releases of a single artist on your site, your homepage can now simply be a track, release or artist page.
If you present releases by multiple artists, Faircamp will automatically create a (virtual) catalog page that it renders as homepage. If you want a "physical" catalog (home)page that you can edit, you can simply create one through a catalog directory and manifest – that is the new (old) catalog.eno file, now always in its own directory though. And what's more, you can now create multiple catalogs, and choose which one should be the homepage.
One last gotcha regarding the possibility for multiple catalogs: With the inital 2.0 release, catalogs always present all (public) releases of the site, and there isn't yet a possiblity to "filter" catalogs in order to present a different selection of releases in each – this however is planned for a future release.
#
Introducing the new setting inheritance system
2
# Introducing the new setting inheritance system
-
+21648 / -11394 / ×191Feb 19, 2026
-
+28087 / -15351 / ×288Mar 27, 2026
Faircamp 1.x (and 0.x before it) had partial, simple implementations of settings inheritance. While these worked very well for most usecases, they always came with one considerable gotcha – it was always either "this setting is passed down no matter what", "this setting is not passed down at all" or some bespoke inbetween logic to handle this in a special way on a case-by-case basis (intransparent and hard to predict).
2.0 comes with a new inheritance model that uses types to establish clear boundaries for inheritance. For instance: In the topmost site.eno manifest, a setting must always be prefixed with a type (artist, catalog, multitrack, or track) in order to be passed down. "artist.theme.mode: light" will enable the light theme for all artists on the site. "multitrack.theme.mode: light" will do the same for all multitrack releases on the site. If a setting should be set across all types there is also the universal prefix (*) – "*.theme.mode: light" will set the light theme across all pages on the site.
When we move to (e.g.) the settings (and manifest) of a multitrack release, there are yet more aspects to discover: Within the multitrack settings we can, but don't need to, use the "multitrack." prefix, because it is implied through the context. "theme.mode: light" enables the light theme for the multitrack, and so does "multitrack.theme.mode: light". However, in both cases the setting is not passed down to the tracks within the multitrack release – for this we would need to specify "track.theme.mode: light", which on its own would only specify a default to be passed down to all tracks, but not affect the theme of the multitrack release itself. The universal setting "*.theme.mode: light" would again be an option that allows us to specify both "multitrack.theme.mode: light" and "track.theme.mode: light" in one declaration.
Although this new model requires a bit of initial familiarization, it squares the circle, allowing to declare settings for either local-only use, inheritance-only use, or both. With the additional type-based filtering it further extends its practical use to previously unsupported applications. And: A great amount of effort went into making this system intuitively discoverable and usable through the graphical interface, which will (if successful) mean that users of the graphical editor will hardly have to think about the design of this (types, prefixing, etc.) and be able to just make use of it.
#
Extended nesting possibilities and the new default manifests
2
# Extended nesting possibilities and the new default manifests
-
+21648 / -11394 / ×191Feb 19, 2026
-
+6949 / -3277 / ×115Feb 27, 2026
Faircamp has always allowed you to group and organize almost everything in your site directory in arbitrarily nested folder hierarchies. In 2.0 this gets expanded in one more area: Track directories within a multitrack directory can now also be deeply nested. Think for instance about a podcast (multitrack) directory that contains (purely organizational) directories for each season, which then contain the (track) directories for all episodes of that season.
All of these purely organizational directories – which aren't themselves artist, catalog, multitrack or track directories – can now also contain so called default manifests. As the name already gives away, these manifests have a single purpose: You can specify any number of (artist, catalog, multitrack, track) default settings in them, which are then passed down to all directories and manifests nested below their directory.
#
Track numbering refinements and new track number setting
2
# Track numbering refinements and new track number setting
-
+1319 / -619 / ×44Jun 06, 2026
-
+271 / -353 / ×38Apr 10, 2026
Track numbers are now optional data – if none are provided, none are displayed on the site or included in the names of download files. Setting or overriding a track number is now possible through the new track.number setting. With the introduction of stand-alone tracks, track numbering can now be configured down to the track-level.
#
Programmatic access to the site tree
2
# Programmatic access to the site tree
-
+21648 / -11394 / ×191Feb 19, 2026
-
+15 / -2 / ×1Jul 14, 2026
2.0 introduces the --export-tree and --render-tree command line options.
With --export-tree you can instruct faircamp to output a JSON file that contains the entirety of the preprocessed site data, including references to all transcoded and prepared media files, ready for site generation.
With --render-tree you can point faircamp to a (previously exported) JSON tree file, instructing it to generate the site based on the preprocessed site tree stored in the file.
To learn more about this see the new Modding & Hacking section in Faircamp's documentation. Please note that the availability and format of this file is not considered stable at this point. While it's less likely that large structural changes will occur, it is very likely that implementation details will change. If you build on top of this and release such tooling to the public it is highly recommend to label it as experimental so people can make informed choices and not run into nasty surprises later on. Thank you for considering this!
# Progress reporting
Rewrite and improve hybrid (CLI/GUI) progress reporting 2
-
+21648 / -11394 / ×191Feb 19, 2026
-
+6949 / -3277 / ×115Feb 27, 2026
# Robustness
Detect and report artist name/alias collisions 1
-
+21648 / -11394 / ×191Feb 19, 2026
Register tag reading failures (previously silently ignored and replaced with empty tags read) 1
-
+6949 / -3277 / ×115Feb 27, 2026
Propagate and gracefully handle io errors for cache, catalog, preprocessing and rendering 1
-
+6949 / -3277 / ×115Feb 27, 2026
# Performance
Use concurrent processing
Draft architecture and base implementation for graphical interface 1
-
+6949 / -3277 / ×115Feb 27, 2026
Isolate audio meta and waveform computation and only conditionally run when needed 2
-
+21648 / -11394 / ×191Feb 19, 2026
-
+6949 / -3277 / ×115Feb 27, 2026
# Port auto-selection
Faircamp's new default preview port is 3247 ("Dial 127.0.0.1:FAIR") 1
-
+53 / -19 / ×3May 04, 2026
Faircamp now auto-selects its preview port from two different ranges (3247-3263, 8080-8096) 1
-
+53 / -19 / ×3May 04, 2026
# Translations
Add welsh translations Henry Young 1
-
+97 / ×5Jul 15, 2026
Update Ukrainian translation before v2 beta Denys Nykula 1
-
+6 / -2 / ×1Jun 28, 2026
Update danish translations Jannis 1
-
+3 / ×2May 22, 2026
Update french translations Jérémie Bertrand 1
-
+3 / ×2Apr 27, 2026
Update lithuanian translations Vac 2
-
+2 / -1 / ×1Apr 27, 2026
-
+13 / -10 / ×1Sep 16, 2026
Update catalan translations Ayman Hamad 1
-
+7 / -1 / ×3Jan 09, 2026
Update polish translations luce 1
-
+23 / -7 / ×2Jan 14, 2026
Update french translations Khawla A.G. 1
-
+3 / -1 / ×2Feb 27, 2026
Update spanish translations Eduardo Hernández Gil 1
-
+21 / -19 / ×2Mar 27, 2026
Update turkish translations atomkarinca 1
-
+6 / -2 / ×1Jul 16, 2026
#
Image processing pipeline
1
# Image processing pipeline
-
+263 / -706 / ×13Jan 18, 2026
The image processing backend has been unified to use a pure rust solution (image). For now this comes with a small performance penalty (libvips is a bit faster) and small feature reduction (HEIF is not yet not supported in the image crate), but it greatly eases distribution and system compatibility for Faircamp, freeing up resources for actual development. Furthermore, the functionality gap between libvips and the image crate is likely going to close fast.
# Bugfixes
Update supported image formats constant, dynamically construct format filters with troschunk 1
-
+44 / -14 / ×9Jul 03, 2026
Use case-insensitive matching for Vorbis header comment keys with Baggypants, dheadshot 2
-
+25 / -9 / ×2May 22, 2026
-
+16 / -9 / ×2Jun 28, 2026
Fall back to GET for failing HEAD requests during download code check with guesst 1
-
+173 / -66 / ×16May 23, 2026
Fix patchy logic for determining varying track artists on a release with incognitothief 1
-
+31 / -9 / ×1Jan 03, 2026
Print detailed debug reports for hard_link_or_copy failure cases 1
-
+28 / -3 / ×2Jan 02, 2026
Prevent console window creation during ffmpeg system calls on Windows with John Townshend 1
-
+16 / ×5Sep 15, 2026
# Misc
Generated asset filenames are now length-constrained to prevent overflowing maximum platform path length limits 1
-
+21648 / -11394 / ×191Feb 19, 2026
The faircamp website has moved to faircamp.org 1
-
+162 / -162 / ×24Apr 30, 2026
The desktop application is now the default build target 1
-
+953 / -898 / ×22Mar 31, 2026
The desktop application splash screen image can be customized for own builds 1
-
+187 / -105 / ×19Jun 21, 2026
Print dynamically retrieved name of current executable in usage hints with lnicola 1
-
+25 / -9 / ×1Jun 12, 2026
Differentiate between latest/stable version builds in build documentation with Wayne Myers 1
-
+11 / ×2Aug 05, 2026
Prelocate ffmpeg, parse/display version, report missing ffmpeg at runtime 1
-
+193 / -17 / ×13Sep 14, 2026
Add use-bundled-ffmpeg/force-bundled-ffmpeg features for bundled distribution 2
-
+193 / -17 / ×13Sep 14, 2026
-
+24 / -1 / ×2Sep 10, 2026
# What had to be left behind
Faircamp was originally designed for command line use only, with the main interface being the folders, files and manifests inside your site directory. With 2.0 it became a hybrid system, supporting both the original filesystem interaction model, as well as interaction through a graphical interface.
Both approaches bring advantages, but also impose specific constraints on how the data model can be structured while still staying representable and comprehensible in both media – there must always be a common denominator.
For a small subset of the original data model it unfortunately proved unfeasible to establish that common denominator. They are:
Shortcut definitions of artists as they could be made in 1.x catalog and release manifests are not available in 2.0 anymore – they were incompatible with 2.0's consistent representation of all objects as nodes in the filesystem. In 2.0 artists are now always represented as directories with a manifest.
Artist manifests could previously live at the root of the site directory. In 2.0, they always need to be placed in their own directory. As with shortcut definitions this allows a consistent representation of artists as stand-alone filesystem nodes.
Releases (and their tracks) could previously be nested inside artists. Vice versa, artists could previously be nested inside releases and their tracks as well. 2.0 introduces a new settings inheritance system in which this kind of nesting would have produced very complex, barely representable (let alone understandable) relations between objects. To ensure usability of the system for everyone (not just graph theoreticians) the data model has therefore been flattened – artists and releases can now only be siblings.
Lastly, the --exclude <PATTERN> and --include <PATTERN> command line options were removed. While these were not at odds with the new data model, they depart somewhat significantly from Faircamp 2.0's general premise of being a hybrid system that is equally usable from the desktop and command line alike, instead representing its own CLI-centric workflow.
# Contributors to this release
#
All commits for this release
254
-
+730 / -14 / ×5Sep 23, 2026
-
+697 / -477 / ×4Sep 21, 2026
-
+197 / -3 / ×11Sep 21, 2026
-
+13 / -10 / ×1Sep 16, 2026
-
+14 / -5 / ×2Sep 15, 2026
-
+16 / ×5Sep 15, 2026
-
+2 / -2 / ×1Sep 15, 2026
-
+71 / -52 / ×5Sep 14, 2026
-
+46 / -75 / ×7Sep 14, 2026
-
+193 / -17 / ×13Sep 14, 2026
-
+1351 / -708 / ×26Sep 14, 2026
-
+24 / -1 / ×2Sep 10, 2026
-
+1 / -1 / ×1Sep 10, 2026
-
+6 / ×3Sep 10, 2026
-
+78 / -27 / ×5Sep 10, 2026
-
+4 / -5 / ×1Sep 06, 2026
-
+21 / -29 / ×5Sep 06, 2026
-
+224 / -82 / ×12Sep 06, 2026
-
+12 / -3 / ×4Sep 03, 2026
-
+11 / -3 / ×1Sep 03, 2026
-
+86 / -25 / ×2Sep 01, 2026
-
+311 / -58 / ×6Sep 01, 2026
-
+112 / -113 / ×6Aug 31, 2026
-
+41 / -4 / ×3Aug 31, 2026
-
+46 / -5 / ×5Aug 31, 2026
-
+23 / -11 / ×16Aug 29, 2026
-
+2 / -1 / ×2Aug 29, 2026
-
+3 / ×1Aug 29, 2026
-
+20 / -25 / ×3Aug 29, 2026
-
+6 / -6 / ×2Aug 29, 2026
-
+6 / -2 / ×2Aug 29, 2026
-
+18 / -32 / ×3Aug 11, 2026
-
+5 / -3 / ×1Aug 11, 2026
-
+11 / ×2Aug 05, 2026
-
+40 / -15 / ×1Aug 04, 2026
-
+3 / -9 / ×3Aug 04, 2026
-
+20 / -5 / ×5Aug 04, 2026
-
+3 / -1 / ×1Aug 03, 2026
-
+14 / -4 / ×3Aug 03, 2026
-
+23 / -11 / ×2Aug 03, 2026
-
+6 / -2 / ×1Jul 16, 2026
-
+16 / -10 / ×3Jul 16, 2026
-
+9 / -5 / ×1Jul 15, 2026
-
+21 / -2 / ×2Jul 15, 2026
-
+57 / -20 / ×1Jul 15, 2026
-
+4 / -2 / ×1Jul 15, 2026
-
+5 / -5 / ×1Jul 15, 2026
-
+30 / -11 / ×5Jul 15, 2026
-
+5 / -1 / ×1Jul 15, 2026
-
+97 / ×5Jul 15, 2026
-
+62 / -89 / ×6Jul 14, 2026
-
+18 / -9 / ×1Jul 14, 2026
-
+5 / -5 / ×5Jul 14, 2026
-
+15 / -2 / ×1Jul 14, 2026
-
+3 / -3 / ×3Jul 14, 2026
-
+112 / -57 / ×6Jul 14, 2026
-
+1 / -1 / ×1Jul 14, 2026
-
+2 / -2 / ×1Jul 08, 2026
-
+33 / -32 / ×8Jul 08, 2026
-
+20 / -3 / ×1Jul 08, 2026
-
-7 / ×1Jul 08, 2026
-
+63 / -26 / ×9Jul 07, 2026
-
+582 / -479 / ×17Jul 06, 2026
-
+4601 / -4488 / ×15Jul 06, 2026
-
+228 / -51 / ×12Jul 06, 2026
-
+223 / -250 / ×16Jul 03, 2026
-
+33 / -8 / ×5Jul 03, 2026
-
+44 / -14 / ×9Jul 03, 2026
-
+104 / -29 / ×3Jul 02, 2026
-
+1175 / -1699 / ×112Jul 02, 2026
-
+33 / -27 / ×3Jul 01, 2026
-
+12 / -8 / ×1Jul 01, 2026
-
+219 / -135 / ×2Jul 01, 2026
-
+35 / -5 / ×1Jul 01, 2026
-
+24 / -15 / ×2Jul 01, 2026
-
+12 / -4 / ×1Jul 01, 2026
-
+1909 / -979 / ×45Jul 01, 2026
-
+119 / -110 / ×7Jun 30, 2026
-
+420 / -162 / ×54Jun 29, 2026
-
+143 / -80 / ×5Jun 29, 2026
-
+94 / ×1Jun 29, 2026
-
+60 / -48 / ×6Jun 29, 2026
-
+734 / -528 / ×70Jun 29, 2026
-
+6 / -2 / ×1Jun 28, 2026
-
+615 / -37 / ×31Jun 28, 2026
-
+12 / -10 / ×2Jun 28, 2026
-
+20 / -13 / ×5Jun 28, 2026
-
+604 / -604 / ×15Jun 28, 2026
-
+71 / -35 / ×1Jun 28, 2026
-
+16 / -9 / ×2Jun 28, 2026
-
+2184 / -799 / ×59Jun 28, 2026
-
+75 / -2 / ×4Jun 26, 2026
-
+284 / -296 / ×9Jun 26, 2026
-
+7 / -9 / ×1Jun 24, 2026
-
+1 / -19 / ×5Jun 24, 2026
-
+176 / -151 / ×30Jun 24, 2026
-
+63 / -58 / ×4Jun 24, 2026
-
+610 / -612 / ×39Jun 24, 2026
-
+3 / -208 / ×8Jun 24, 2026
-
+196 / -69 / ×19Jun 24, 2026
-
+44 / -40 / ×7Jun 24, 2026
-
+88 / -27 / ×8Jun 24, 2026
-
+306 / -247 / ×59Jun 23, 2026
-
+793 / -565 / ×40Jun 23, 2026
-
+441 / -414 / ×6Jun 23, 2026
-
+80 / -44 / ×9Jun 23, 2026
-
+244 / -149 / ×3Jun 22, 2026
-
+28 / -10 / ×2Jun 22, 2026
-
+133 / -13 / ×13Jun 22, 2026
-
+5 / -4 / ×1Jun 21, 2026
-
+2 / -2 / ×1Jun 21, 2026
-
+78 / -53 / ×11Jun 21, 2026
-
+519 / -375 / ×13Jun 21, 2026
-
+182 / -93 / ×13Jun 21, 2026
-
+46 / -18 / ×6Jun 21, 2026
-
+187 / -105 / ×19Jun 21, 2026
-
+156 / -226 / ×15Jun 19, 2026
-
+10 / -6 / ×4Jun 19, 2026
-
+474 / -534 / ×33Jun 19, 2026
-
+166 / -103 / ×15Jun 18, 2026
-
+438 / -102 / ×6Jun 18, 2026
-
+2464 / -1792 / ×62Jun 18, 2026
-
+97 / -11 / ×5Jun 16, 2026
-
+160 / -135 / ×20Jun 16, 2026
-
+218 / -91 / ×7Jun 16, 2026
-
+69 / -5 / ×2Jun 16, 2026
-
+25 / -9 / ×1Jun 12, 2026
-
+748 / -489 / ×38Jun 12, 2026
-
+113 / -97 / ×4Jun 11, 2026
-
+6 / -6 / ×4Jun 11, 2026
-
+179 / -86 / ×8Jun 11, 2026
-
+182 / -178 / ×2Jun 10, 2026
-
+35 / -36 / ×9Jun 10, 2026
-
+31 / -22 / ×3Jun 10, 2026
-
+460 / -329 / ×11Jun 10, 2026
-
+21 / -7 / ×4Jun 10, 2026
-
+517 / -173 / ×4Jun 10, 2026
-
+2 / ×1Jun 09, 2026
-
+2395 / -1009 / ×49Jun 09, 2026
-
+30 / -11 / ×5Jun 06, 2026
-
+5 / -2 / ×3Jun 06, 2026
-
+211 / -149 / ×25Jun 06, 2026
-
+1319 / -619 / ×44Jun 06, 2026
-
+478 / -283 / ×47Jun 05, 2026
-
+397 / -33 / ×25Jun 04, 2026
-
+324 / -141 / ×12Jun 03, 2026
-
+171 / -23 / ×23Jun 03, 2026
-
+6 / -6 / ×2Jun 02, 2026
-
+226 / -121 / ×18Jun 02, 2026
-
+6 / -3 / ×1Jun 02, 2026
-
+645 / -345 / ×13Jun 02, 2026
-
+21 / -6 / ×4Jun 02, 2026
-
+54 / -14 / ×2Jun 01, 2026
-
+237 / -35 / ×18Jun 01, 2026
-
+153 / -1 / ×7Jun 01, 2026
-
+1558 / -1399 / ×20Jun 01, 2026
-
+5089 / -946 / ×52May 27, 2026
-
+173 / -66 / ×16May 23, 2026
-
+4 / -1 / ×1May 23, 2026
-
+41 / -16 / ×1May 23, 2026
-
+3 / ×2May 22, 2026
-
+25 / -9 / ×2May 22, 2026
-
+2733 / -2245 / ×32May 18, 2026
-
+62 / -9 / ×5May 14, 2026
-
+345 / -223 / ×21May 13, 2026
-
+1367 / -647 / ×10May 13, 2026
-
+39 / ×1May 13, 2026
-
+7503 / -5974 / ×164May 13, 2026
-
+124 / ×1May 08, 2026
-
+6658 / -5872 / ×97May 08, 2026
-
+369 / -118 / ×21May 04, 2026
-
+3 / -1 / ×1May 04, 2026
-
+53 / -19 / ×3May 04, 2026
-
+296 / -128 / ×21May 02, 2026
-
+445 / -411 / ×37May 02, 2026
-
+1658 / -1383 / ×65May 02, 2026
-
+162 / -162 / ×24Apr 30, 2026
-
+722 / -773 / ×13Apr 30, 2026
-
+677 / -67 / ×54Apr 30, 2026
-
+211 / -29 / ×31Apr 30, 2026
-
+354 / -210 / ×41Apr 30, 2026
-
+567 / -294 / ×47Apr 30, 2026
-
+367 / -42 / ×47Apr 29, 2026
-
+783 / -465 / ×73Apr 28, 2026
-
+42 / -70 / ×2Apr 28, 2026
-
+653 / -353 / ×32Apr 28, 2026
-
+3 / ×2Apr 27, 2026
-
+2 / -1 / ×1Apr 27, 2026
-
+638 / -241 / ×41Apr 21, 2026
-
+3 / -1 / ×2Apr 21, 2026
-
+632 / -92 / ×32Apr 21, 2026
-
+71 / -221 / ×17Apr 21, 2026
-
+21 / -28 / ×3Apr 21, 2026
-
+1094 / -804 / ×59Apr 21, 2026
-
+232 / -146 / ×10Apr 20, 2026
-
+367 / -361 / ×4Apr 20, 2026
-
+12 / ×4Apr 20, 2026
-
+100 / ×16Apr 16, 2026
-
+6 / -6 / ×3Apr 16, 2026
-
+211 / -33 / ×14Apr 16, 2026
-
+54 / -2 / ×10Apr 16, 2026
-
+241 / -94 / ×31Apr 16, 2026
-
+3 / -3 / ×2Apr 16, 2026
-
+1483 / -1419 / ×28Apr 16, 2026
-
+279 / -29 / ×25Apr 15, 2026
-
+177 / -174 / ×46Apr 15, 2026
-
+40 / -1 / ×5Apr 15, 2026
-
+708 / -475 / ×41Apr 15, 2026
-
+788 / -250 / ×44Apr 15, 2026
-
+93 / -93 / ×18Apr 14, 2026
-
+51 / -63 / ×9Apr 14, 2026
-
+156 / -165 / ×22Apr 14, 2026
-
+29 / -12 / ×3Apr 14, 2026
-
+9 / -8 / ×2Apr 10, 2026
-
+559 / -174 / ×66Apr 10, 2026
-
+271 / -353 / ×38Apr 10, 2026
-
+47 / -132 / ×15Apr 10, 2026
-
+18 / -14 / ×4Apr 10, 2026
-
+390 / -154 / ×27Apr 10, 2026
-
+155 / -47 / ×8Apr 09, 2026
-
+1 / -1 / ×1Apr 09, 2026
-
+965 / -458 / ×16Apr 09, 2026
-
+348 / -178 / ×17Apr 08, 2026
-
+779 / -483 / ×59Apr 07, 2026
-
+609 / -278 / ×32Apr 07, 2026
-
+953 / -898 / ×22Mar 31, 2026
-
+4 / -4 / ×1Mar 30, 2026
-
+3 / ×1Mar 30, 2026
-
+49 / -36 / ×7Mar 30, 2026
-
+4 / -2 / ×1Mar 30, 2026
-
+63 / -1306 / ×5Mar 30, 2026
-
+310 / -41 / ×9Mar 28, 2026
-
+340 / -86 / ×24Mar 27, 2026
-
+675 / -675 / ×34Mar 27, 2026
-
+21 / -19 / ×2Mar 27, 2026
-
+28087 / -15351 / ×288Mar 27, 2026
-
+719 / -78 / ×26Feb 28, 2026
-
+119 / -43 / ×11Feb 27, 2026
-
+3 / -1 / ×2Feb 27, 2026
-
+6949 / -3277 / ×115Feb 27, 2026
-
+1081 / -721 / ×5Feb 19, 2026
-
+21648 / -11394 / ×191Feb 19, 2026
-
+263 / -706 / ×13Jan 18, 2026
-
+23 / -7 / ×2Jan 14, 2026
-
+4276 / -4245 / ×37Jan 13, 2026
-
+26477 / -26092 / ×269Jan 13, 2026
-
+7115 / -1769 / ×12Jan 12, 2026
-
+7 / -1 / ×3Jan 09, 2026
-
+9 / -5 / ×1Jan 07, 2026
-
+183 / -197 / ×4Jan 07, 2026
-
+27661 / -27596 / ×286Jan 07, 2026
-
+272 / -204 / ×12Jan 04, 2026
-
+31 / -9 / ×1Jan 03, 2026
-
+28 / -3 / ×2Jan 02, 2026