prime

For a masterable, comfy and distraction-free setup!

 ______   ______     __     __    __     ______    
/\  == \ /\  == \   /\ \   /\ "-./  \   /\  ___\   
\ \  _-/ \ \  __<   \ \ \  \ \ \-./\ \  \ \  __\   
 \ \_\    \ \_\ \_\  \ \_\  \ \_\ \ \_\  \ \_____\ 
  \/_/     \/_/ /_/   \/_/   \/_/  \/_/   \/_____/ 

I need a system that:

• Gets me to my goals (passing exams, shipping and excelling at my craft over time).
• Is minimal¹ (kind of elitist) with an effective and coherent toolset.
• Has low overhead once it clicks and builds little fatigue while using it².
• Takes no time installing, can be³ secure and has no big corpo telemetry.

Is that you⁴? Great! Then read the rest.

Builds

There are four builds available, all of which are based on the latest Void Linux x86_64-glibc.

• Headless (headless-prime.iso), the toolset plus the drivers, almost nothing else.
• Xorg (xorg-prime.iso), everything headless has plus audio, bluetooth,
  fonts, graphics and various applications.
• Gaming (gaming-prime-iso), same as xorg, but with insecure kernel boot
  options (for a performance increase up to 20%), Heroic and various emulators.
• Personal (personal-prime.iso), same as xorg plus highly opinionated additions such as VSCode.

Caution

Your system will be vulnerable to Meltdown and a lot more if you choose to use insecure boot options, but unless someone is on your computer having fun with process hacking, you are probably good.

Headless

Packages are (mostly) organized by the following priority order:
Kernel > Shell > Userland (non‑network) > Userland (network) > Daemons and
within each priority, grouped by origin: Linux project > GNU project > Other projects.

Pure driver packages are not listed, but are installed as part of the system and very much essential.

Toolset

• linux and kmod: kernel and modules
• dracut: generate initramfs
• grub: bootloader
• efibootmgr: manage uefi boot entries
• os-prober: detect other operating systems
• runit: init system
• glibc: libc
• bash and dash: user and system shell
• tmux: multiplexer
• tmate: share terminal
• skim: fuzzy finder
• usbutils: usb utilities
• util-linux: system utilities
• procps-ng: process utilities
• coreutils: core utilities
• findutils: find utilities
• grep: pattern matching
• sed: stream editor
• less: pager
• man and texinfo: read documentation
• atool (supporting gzip, tar, xz, 7z, zip and rar): archive and unarchive
• e2fsprogs, btrfs-progs and xfsprogs: ext4, btrfs, xfs disk utilities
• f2fs-tools, dosfstools and exfat-utils: fat and exfat utilities
• ntfs-3g: ntfs disk utilities
• sudo: privilege escalation
• shadow: users and groups
• xxd: format in octal, hexadecimal and binary
• helix: modern editor
• which: show full command path
• file: detect file type
• xbps and vpm: manage packages
• android-tools and scrcpy: mobile devices
• ethtool: query and control network driver and hardware
• openssl: cryptography
• curl: send http and socks requests
• trurl: parse and manipulate urls
• jq: json processor
• traceroute: follow network packets
• iproute2 and iputils: network utilities
• wget: http and ftp download utility
• gallery-dl: download images from various websites
• yt-dlp: download videos from various websites
• openssh: secure remote shell
• acpid: handle acpi events
• eudev: device manager
• agetty: manage ttys
• cronie: cron implementation
• ntp and chrony: time synchronization
• dhcpcd: dhcp client
• iw and iwd: wifi
• iptables and ip6tables: firewall
• tlp: power management
• docker, docker-buildx and docker-compose: containers

Languages

• asm/c
  • binutils: binary utilities
  • bison: parser generator
  • flex: lexer
  • m4: macro processor
  • make: build system
  • autoconf and automake: portable software builds
  • pkg-config: retrieve information about installed libraries
  • gcc: compiler collection
  • gdb: debugger
  • strace: trace syscalls
  • ltrace: trace library calls
  • rizin: binary exploitation, process hacking and reverse engineering
• gawk: awk implementation
• go: compiled garbage collected language
  • delve: debugger
• python: runtime object oriented language
  • pip: package manager
• gleam: runtime functional language
• sqlite: embeddable sql database
• typst, troff and groff: typesetting
• diffutils: diff utilities
• patch: patch source files
• git and github-cli: version control system
• protobuf: protocol buffers

Additional

Packages that are not part of the toolset, but are included in headless.

• kbd: keyboard utilities (ttys)
• gettext: localization
• bc: basic calculator
• ed: standard editor
• nvi: visual editor

Xorg

• dbus: message bus system
• elogind: user logins and seats
• polkit: policy framework
• pipewire, wireplumber and wiremix: audio
• bluez: bluetooth
• xorg and xinit: display server
  • xrandr: manage monitors
  • xinput and setxkbmap: configure mouse and keyboard (xorg)
  • xclip: clipboard
  • xprop: display window properties
  • xset: change display server properties
• noto (including cjk and emojis): system fonts
• jetbrains mono, 0xproto, commit mono and mononoki: programming fonts
• dk: window manager
• sxhkd: hotkey daemon
• dmenu: launcher
• scrot: screenshot
• xautolock and slock: lock screen
• xwallpaper: set wallpaper
• ranger: file manager
• nsxiv: view images
• kew: listen to music
• mpv: play videos
• ffmpeg: manipulate audios and videos
• zathura (supporting pdf, epub, xps, cbz, cbr, cb7 and cbt): read documents

Apps

• chromium and qutebrowser: browse the web
• obs: record and live stream
• qbittorrent: torrent
• cutter: rizin frontend

In addition to the drivers, language servers, linters, and formatters some languages are also installed.

Documentation

• GNU
• Linux
• Helix
• Curl
• Jq
• Rizin
• Go
• Python
• Gleam
• SQLite
• Typst
• Git
• GitHub
• Caddy
• Docker
• Kubernetes
• Traefik
• Amazon Web Services
• Tencent Cloud
• HashiCorp
• Pulumi
• Grafana
• Void

Check out the highly curated quickmarks for more!

Tip

Offline? Use man to access manual pages.
Use info to access the GNU documentation system.

Don't use fucking AI⁵ whenever you can't understand something.

Screenshots

Is it supposed to look this pretty?
That's not the point, but I'm happy it does!

Installation

1. Boot it up and run sudo void-installer, follow the process and done 🎉!
   You know how to partition and where to mount stuff, you are a big boy/girl.

Tip

Make sure to pick the services and groups you want!
Enable both iwd and wpa_supplicant if you need Wi-Fi!

2. Now log into your new system and get the remaining drivers.

Note

Some of these might already be installed.
Better safe than sorry!

CPU microcode

# For Intel CPUs
vpm install linux-firmware-intel
# For AMD CPUs
vpm install linux-firmware-amd

GPU drivers

# For AMD GPUs
vpm install mesa-vulkan-radeon xf86-video-amdgpu xf86-video-ati
# For Nvidia GPUs
vpm install nvidia nvidia-vaapi-driver nvidia-docker
# For Intel GPUs
vpm install intel-video-accel intel-media-driver

3. Lastly, make sure your ~/.xinitrc is just the way you want it!

Tips

Prime comes with Qutebrowser and Chromium installed.

To preserve your mental health while browsing the modern internet try using a network-wide DNS adblocker such as NextDNS if you decide to use Qutebrowser.

Use uBlock Origin and YouTube Unhook on Chromium to achive the same.

Don't forget to install your ~/.gitconfig and ~/.ssh keys!

[user]
  email = sansneolink@gmail.com
	name = Alberto Chiaravalli
	signingkey = ~/.ssh/sign.pub
[gpg]
	format = ssh
[commit]
	gpgsign = true
[init]
	defaultBranch = main
[pull]
	rebase = true

Edit /etc/dhcpcd.conf to specify your preferred DNS servers (by default, Cloudflare's DNS is used).
To prevent dhcpcd from overwriting your /etc/resolv.conf, uncomment nohook resolv.conf.
To use your gateway's default DNS server, comment nooption domain_name_servers and nooption rdnss.

Remove the default Helix themes to keep exlusively my selection.

sudo rm -r /usr/lib/helix/runtime/themes

Install goimports (not in the repositories) for on-format automatic imports with Go.

go install golang.org/x/tools/cmd/goimports@latest

You can run the kubectl, aws-cli and terraform as Docker containers.
This requires the containerd and docker services to be running.

Gaming

The homonymous build comes with these installed:

• heroic : play native and windows (with proton) games
• mgba: play nintendo gba games through an emulator
• melonds: play nintendo ds games through an emulator
• dolphin: play nintendo wii games through an emulator
• cemu: play nintendo wii u games through an emulator
• ryujinx: play nintendo switch games through an emulator

Note

I don't really play games anymore, but it's super cool that almost every game runs flawlessly with no setup required on Linux now!
One limitation is (usually competitive) multiplayer games with kernel level anti-cheats.
Heroic can install pirated⁶ games by first running Warez scene installers.

Building

Warning

Do this on a Void Linux with qemu-user-static, unzip, curl and wget installed.

1. Clone the repo

git clone https://github.com/sansneo/prime
cd prime
git submodule update --init --remote

2. Become root and run build.sh

su
sh build.sh

This will take a while...
The resulting files will be available in build/.
To learn more, take a look at build.sh and refer to void-linux/void-mklive.

Conclusion

I love my computer! Do you?

Please, get the fuck out of technology if you are here for the money.
Because of the state of the world there's a lot of that to be made here if you actually care about doing something real and creating value by making infrastructures and computers better instead of just moving data around.

I really enjoy everything systems programming, secure backend development and cloud, so I'll be doing that.
As time passes I look up to legends such as Rob Pike, Russ Cox and George Hotz more and more.
I am 22 years old at the time of writing this, in my 30s I'll have a pretty good understanding of my toolset and computers in general, then hopefully, in my 40s I'll be able to compare to them.

Thanks to computers, I have the knowledge.
Thanks to luck, I have the genetics.
What's stopping me?

Life can be beautiful (even if it definitely can feel dark at times), self-improvement is the best and my drive for doing what I do will forever grow. I believe in you, dear reader.

We won't stand for mediocrity.

P.S. My Instagram is mostly a face thing and way too distracting for me to actually use.
Write me an email or ask me to add you on WhatsApp <3. Thanks for reading!

Footnotes

Footnotes

1. Yes, this is a Linux kernel with the GNU userspace plus a lot more meaning complexity is gonna be pretty high compared to something like OpenBSD or Plan 9, but I can't compromise on functionality and focusing on the toolset alone, it's really not that bad given you have 20 years to spare, point is, it's doable! ↩

2. This is the real enemy we face as developers, we need to reduce overhead and that mental fatigue that slowly builds while we work! Here's a video from The Primeagen I really liked which touches on the topic. ↩

3. If you use a modern CPU on a non-core/libre (meaning modern basically) system, if you are holding a non-rooted phone with Google services running on it (meaning you are a normal person), if you often use something like Discord (eww) or play video games like Valorant (maybe try something single-player or fun with friends) or Rainbow Six Siege that have a kernel-level anti-cheat running, your super secure private hacker ideological setup starts to look cringey. Prime is secure and practical in all the right ways IMO. ↩

4. You can't use Prime unless you bench at least 60kg and are really hot. ↩

5. Come on, really? Up until AIs can write a complete authentication API that's not vulnerable to BOLA, CSRF or anything else in the API OWASP TOP-10 I will use it very rarely and ask questions I know are common knowledge, it does not work for anything really niche and overly specific, at least for now. ↩

6. In a world where so many companies do not care about quality of product as compared to the monetary game, you need to use like 7 different subscription based streaming platforms to watch a whole show and AAA game studios often shit out low effort games at full price, I believe it's totally fair to pirate things. Keep a list of the media you love, shows, games and music you didn't pay for (knowledge shouldn't be paywalled and there's great value there), then give back once rich.
   Counter argument, what if everyone does this? Most people are just not technical enough, be grateful you are and enjoy! ↩