buninu-linux 0.7.1 → 0.7.2

package/README.md

@@ -46,7 +46,7 @@
     + Also has mouse click, wheel, and cursor drawing
     + Simplified browser works: @sanohiro/casty in chroot debian
     + (Use at your own risk: We haven't fully examined its code)
-    + Playing YouTube with sound(experimental)
+    + Playing YouTube with sound (experimental); see [Playing YouTube with sound](#playing-youtube-with-sound-experimental)
     + See [Commands inside `/bin`](#commands-inside-bin) for browser usage instructions
 
 ---
@@ -373,7 +373,7 @@ If `Enter` is not recognized in a particular terminal, try `Ctrl-J` or
 - Be careful not to run markdown files from strangers
   * Otherwise it can run any command on your PC
 - `jsmdcui --cdp-maze` runs a self-solving maze game
-  * Run `bunterm` first to show its Emojis
+  * Run `bunterm 2` first to show its Emojis
 
 ### Multitasking modes
 
@@ -480,11 +480,13 @@ syntax, interactive controls, builtins, and current compatibility details.
 ### Showing images
 
 The Linux text console cannot draw pictures, so first start `bunterm`, the
-graphical terminal on the framebuffer, and run the image commands inside it:
+graphical terminal on the framebuffer, and run the image commands inside it.
+Start it on another virtual console so tty1 keeps the `bun-repl>` prompt for
+hardware setup (`Ctrl+Alt+F1` goes back to it):
 
 ```sh
-# Start the graphical terminal on this virtual console (or name one: bunterm /dev/tty1)
-bunterm
+# Start the graphical terminal on VT 2 (same as bunterm /dev/tty2)
+bunterm 2
 
 # Show an image with the kitty graphics protocol (jsgotty --viu)
 showimg /buninu/icon.png
@@ -497,7 +499,8 @@ buninu-help
 jsmdcui --allow-url README.md
 
 # The mouse works in bunterm; --no-mouse leaves /dev/input alone
-bunterm -e jsmdcui --allow-url README.md
+# (VT 3, since VT 2 already has the bunterm started above)
+bunterm 3 -e jsmdcui --allow-url README.md
 ```
 
 `bunterm` draws with Skia (CanvasKit) and understands the kitty graphics
@@ -534,6 +537,67 @@ bun x @drxiaozhi/jspinyin
   OSC 52, and `Ctrl-V` pastes it in jsmdcui or jspinyin, since jsmdcui reads
   from `xclip` first by default.
 
+### Playing YouTube with sound (experimental)
+
+[jspulse](https://www.npmjs.com/package/@drxiaozhi/jspulse) is a
+PulseAudio-compatible sound server written for Bun. It runs natively in
+Buninu, outside any chroot, and plays through ALSA. Chromium-based programs
+such as `casty` inside the Debian chroot connect to it over `127.0.0.1`,
+because a chroot shares Buninu's network. Several programs can play at once.
+
+This assumes the Debian chroot and `casty` from
+[Commands inside /bin](#commands-inside-bin) are already set up, with the
+chroot shell on tty2. `bun x` needs network access; see
+[Basic configuration](#basic-configuration).
+
+1. **Load the sound drivers.** Press `Ctrl+Alt+F1` to go to the `bun-repl>`
+   prompt on tty1 and run:
+
+   ```js
+   cfg.sound
+   ```
+
+2. **Open a native Buninu terminal.** Still on tty1, enter the Buninu shell
+   with `start()`, then open another virtual console from that shell (see
+   [Multitasking modes](#multitasking-modes)). Run the next two steps there,
+   *not* inside the chroot:
+
+   ```js
+   start()
+   ```
+
+   ```sh
+   bunterm 3
+   ```
+
+3. **Set the volume, then test the speakers.** Setting a volume also unmutes
+   the output, so the 3-second test tone is guaranteed to be audible. Adjust
+   the percentage afterwards if it is too quiet or too loud:
+
+   ```sh
+   bun x @drxiaozhi/jspulse --volume 50
+   bun x @drxiaozhi/jspulse --play
+   ```
+
+4. **Start the sound server.** It keeps running in the foreground, so leave
+   this terminal as it is; `Ctrl+C` stops it:
+
+   ```sh
+   bun x @drxiaozhi/jspulse --alsa
+   ```
+
+5. **Start casty with sound.** Press `Ctrl+Alt+F2` to return to the chroot
+   shell, point PulseAudio clients at jspulse, and start casty:
+
+   ```sh
+   export PULSE_SERVER=127.0.0.1
+   cd ~/casty/bin
+   bun casty.js https://www.youtube.com
+   ```
+
+If there is no sound, check step 4's terminal for errors, and make sure
+`PULSE_SERVER` was exported in the same shell that started casty.
+
 ## Commands inside /bin
 
 | command | does | manual |
@@ -581,14 +645,14 @@ umount -R /mnt
 bun x bunproot --git clone https://github.com/jjtseng93/bunproot
 
 # Read bunproot's Git manual without ANSI formatting in jmi
-bunterm
+bunterm 2
 bun x bunproot --git --readme | stripansi | jmi
 
 
 
 # Download and enter an x64 Debian rootfs
 # Make sure you have run this already:
-#   bunterm --font-size 13
+#   bunterm 2 --font-size 13
 bun x bunproot --git --yes clone https://github.com/jjtseng93/js-udocker
 cd js-udocker
 bun udocker.js pull --platform=linux/amd64 debian:13
@@ -618,10 +682,8 @@ git clone https://github.com/jjtseng93/casty
 cd casty/bin
 # When clicking around, don’t release the mouse button immediately after pressing it, to make sure the mouse-down event is triggered
 bun casty.js buninu.org
-# Playing YouTube with sound(experimental)
-# make sure you have run `cfg.sound` in bun-repl
-# follow the dumped instructions
-bun x bunproot --setup.pulse
+# For sound in casty (YouTube), start jspulse first:
+# see "Playing YouTube with sound (experimental)" under "Using Buninu Linux"
 
 
 # Download and enter an x64 Alpine minirootfs
@@ -668,9 +730,9 @@ tar xvf /tmp/buninu.tar -C /tmp/buninu-copy
 # Add z to create a gzip-compressed archive
 tar czvf /tmp/buninu.tar.gz README.md package.json
 
-# On a virtual console: a graphical terminal with CJK, emoji and images
-bunterm
-bunterm /dev/tty1 --font-size 13 -e bun /buninu/apps/jsmdcui/src/index.js --demo
+# On another virtual console: a graphical terminal with CJK, emoji and images
+bunterm 2
+bunterm /dev/tty3 --font-size 13 -e bun /buninu/apps/jsmdcui/src/index.js --demo
 ```
 
 The graphics stack behind `bunterm` — the framebuffer module, CanvasKit,
@@ -1200,6 +1262,7 @@ for the userspace session.
   * [Using Bun Modern Shell](#using-bun-modern-shell)
   * [Showing images](#showing-images)
   * [Clipboard](#clipboard)
+  * [Playing YouTube with sound (experimental)](#playing-youtube-with-sound-experimental)
 - [Commands inside /bin](#commands-inside-bin)
 - [Environment and dependencies](#environment-and-dependencies)
   * [Build environment](#build-environment)

package/build-uki.sh

@@ -14,11 +14,7 @@ fi
 ./scripts/pack-initramfs.sh
 
 mkdir -p build vda/EFI/BOOT
-printf '%s\n' \
-    'NAME="Buninu Linux"' \
-    'ID=buninu-linux' \
-    'PRETTY_NAME="Buninu Linux 1"' \
-    'VERSION_ID=1' > build/os-release
+# build/os-release is written by pack-initramfs.sh from package.json.
 # Bun itself is PID 1: no native bootstrap. `-e import('/init.js')` avoids the
 # entry-file open that would readlink /proc/self/fd/N before /proc exists;
 # init.js mounts /proc, /sys, /dev and /tmp as its first action.

package/initramfs/buninu/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.17 - 2026-09-26
+
+- readme: Add homepage URL
+
+## 0.4.16 - 2026-09-22
+
+- Update homepage to <https://buninu.org>
+
 ## 0.4.15 - 2026-09-22
 
 ### Changed

package/initramfs/buninu/README.md

@@ -23,6 +23,7 @@ npx buninu
 > (`--local`, bunmsh) has no job control yet, so use the browser terminal when
 > you need to background a job.
 
+- Homepage: <https://buninu.org>
 - Source: [github.com/jjtseng93/buninu](https://github.com/jjtseng93/buninu)
 
 - Core components:

package/initramfs/buninu/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buninu",
-  "version": "0.4.15",
+  "version": "0.4.17",
   "description": "Buninu is a portable, self-bootstrapping Unix-like userspace built on Bun that runs across operating systems",
   "type": "module",
   "main": "./bin/init.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "git+https://github.com/jjtseng93/buninu.git"
   },
-  "homepage": "https://github.com/jjtseng93/buninu#readme",
+  "homepage": "https://buninu.org",
   "bugs": {
     "url": "https://github.com/jjtseng93/buninu/issues"
   },

package/initramfs/usr/share/doc/buninu-linux/bunterm.md

@@ -6,9 +6,9 @@ xterm-compatible terminal with anti-aliased text, CJK, colour emoji, seamless
 box drawing and kitty graphics protocol images — no X11, Wayland or GPU.
 
 ```sh
-bunterm                      # run /bin/sh on the console you are on
 bunterm 2                    # start a detached bunterm on /dev/tty2
-bunterm /dev/tty1            # the full virtual-console spelling also works
+bunterm /dev/tty2            # the full virtual-console spelling also works
+bunterm                      # take over the console you are on (on tty1 that hides the bun-repl)
 bunterm -s 20                # short for --font-size 20
 bunterm -e bun /buninu/apps/jsmdcui/src/index.js --demo
 bunterm --no-mouse          # keyboard only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buninu-linux",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "A Linux distribution running Bun as PID 1 with the Buninu userspace.",
   "type": "module",
   "main": "./index.js",

package/scripts/pack-initramfs.sh

@@ -27,6 +27,29 @@ cp -a --reflink=auto "$native_dir/." "$staging/"
 cp README.md "$staging/usr/share/doc/buninu-linux/README.md"
 cp -a LICENSE NOTICE.md LICENSES "$staging/usr/share/licenses/"
 
+# os-release(5): the canonical file lives in /usr/lib and /etc/os-release links
+# to it. build-uki.sh embeds the same file as the UKI's .osrel section.
+version="$(sed -n 's/^ *"version": *"\([^"]*\)".*/\1/p' package.json | head -n 1)"
+test -n "$version" || { echo "error: no version in package.json" >&2; exit 1; }
+printf '%s\n' \
+    'NAME="Buninu Linux"' \
+    'ID=buninu-linux' \
+    "VERSION=\"$version\"" \
+    "VERSION_ID=$version" \
+    "PRETTY_NAME=\"Buninu Linux $version\"" \
+    'HOME_URL="https://buninu.org"' \
+    'BUG_REPORT_URL="https://github.com/jjtseng93/buninu-linux/issues"' \
+    'LOGO=buninu-linux' \
+    'DEFAULT_HOSTNAME=buninu' > build/os-release
+mkdir -p "$staging/usr/lib" "$staging/etc"
+cp build/os-release "$staging/usr/lib/os-release"
+ln -sfn ../usr/lib/os-release "$staging/etc/os-release"
+# LOGO names an icon-theme icon; point the standard lookup paths at the Buninu
+# icon that /buninu already ships instead of packing a second copy.
+mkdir -p "$staging/usr/share/icons/hicolor/512x512/apps" "$staging/usr/share/pixmaps"
+ln -sfn ../../../../../../buninu/icon.png "$staging/usr/share/icons/hicolor/512x512/apps/buninu-linux.png"
+ln -sfn ../../../buninu/icon.png "$staging/usr/share/pixmaps/buninu-linux.png"
+
 # fakeroot lets cpio record the character devices without real root. Nothing
 # has mounted devtmpfs when the kernel execs Bun as PID 1, so every device
 # Bun's startup needs has to be in the archive itself: