Skip to content

fix: ensure CalOS branding wins in fastfetch and os-release - #50

Merged
freebuff-web[bot] merged 2 commits into
mainfrom
fix/fastfetch-osrelease-branding
Aug 29, 2026
Merged

freebuff-web[bot] merged 2 commits into
mainfrom
fix/fastfetch-osrelease-branding

Conversation

@freebuff-web

@freebuff-web freebuff-web Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Problem

Running fastfetch reports the base Bluefin distro ("Bluefin stable") and uses the inherited logo instead of the CalOS ASCII logo.

Root causes found (verified against fastfetch's source):

  1. fastfetch reads /etc/os-release FIRST, only falling back to /usr/lib/os-release when fields are missing. The image only overlaid /usr/lib/os-release, so if the base ships a plain /etc/os-release, installed systems keep reporting the base distro.
  2. FASTFETCH_CONFIG is not a real fastfetch feature — there is no such env var anywhere in fastfetch's source (config resolution is --config + fastfetch/config.jsonc in ~/.config, $HOME, $XDG_CONFIG_DIRS, /etc/xdg, /etc). The build shipped dead env exports that made it look like the CalOS preset was being forced when it never was.

Changes

  • build_files/build.sh: ln -sf ../usr/lib/os-release /etc/os-release so branding always wins; remove the dead FASTFETCH_CONFIG exports; document the real mechanism. The system-wide /etc/fastfetch/config.jsonc + /etc/skel + presets/calos.jsonc layout was already correct — fastfetch does honor /etc/fastfetch/config.jsonc for users without their own ~/.config copy.
  • freebuff/BRANDING_SYSTEM.md: corrected the fastfetch configuration description.
  • docs/latest-release.js, docs/script.js, README.md, build-disk.yml comments: bumped stale release examples from v1.1.4 → v1.1.5.

Note for existing installs

New users and users without a private ~/.config/fastfetch/config.jsonc will get the CalOS logo + "CalOS" immediately after updating. Users with an existing personal fastfetch config keep their own config (correct behavior) — delete ~/.config/fastfetch to restore the CalOS default. An update is required for the fixes to land (ujust update / bootc upgrade).

Fastfetch showed "Bluefin stable" and the base image's defaults because it
reads /etc/os-release FIRST (falling back to /usr/lib/os-release), and the
image relied on an unsupported FASTFETCH_CONFIG env var that fastfetch never
reads.

- build.sh: symlink /etc/os-release to the CalOS-branded /usr/lib/os-release
- build.sh: drop dead FASTFETCH_CONFIG exports; document that fastfetch loads
  fastfetch/config.jsonc from ~/.config, $HOME, $XDG_CONFIG_DIRS, /etc/xdg,
  /etc, and rely on /etc/fastfetch/config.jsonc + skel + preset instead
- docs/BRANDING_SYSTEM.md: describe the actual fastfetch config mechanism
- docs, README, workflow comments: bump release examples to v1.1.5

Co-Authored-By: Codebuff <noreply@codebuff.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation build ci freebuff labels Aug 29, 2026
Missed during the org migration — discussions and SECURITY links still
pointed at callenflynn/CalOS.

Co-Authored-By: Codebuff <noreply@codebuff.com>
@freebuff-web
freebuff-web Bot merged commit 502afaf into main Aug 29, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build ci documentation Improvements or additions to documentation freebuff

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant