buninu-linux 0.7.1 → 0.7.3

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,18 @@
 # Changelog
 
+## 0.4.18 - 2026-09-29
+
+- Sync jsgotty to 1.1.14: Kitty for Windows
+- Sync bunmsh to 0.3.10: Fix several posix/gnu/external builtin commands
+
+## 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/apps/bunmsh/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable user-visible changes to bunmsh are documented here.
 
+## [0.3.10] - 2026-09-29
+
+### Fixed
+
+- Match system utilities when handling multiple operands: `printf` repeats its
+  format for remaining arguments; `ln` links multiple sources into a directory;
+  `head`, `tail`, `wc`, and `cut` process each file separately; and `md5sum` and
+  `sha256sum` print one labelled digest per file. `wc` also prints a total for
+  multiple files. Reference tests compare these results with system commands.
+
+- Make `grep -r PATTERN` without an explicit path search the current directory,
+  as system `grep` does, instead of reading a locked standard-input stream.
+  Reference tests cover recursive matches, line numbers, no matches, and quiet
+  mode.
+
 ## [0.3.9] - 2026-09-22
 
 ### Fixed

package/initramfs/buninu/apps/bunmsh/PORTING.md

@@ -32,8 +32,12 @@ pseudo-terminal tests.
 
 ### Grammar and execution
 
-- Background jobs (`&`), job control, coprocesses, and asynchronous command
-  lists are not implemented.
+- A final, standalone, unquoted `&` starts a single external command in the
+  background (trailing comments and newlines are allowed). Stdin is ignored;
+  stdout/stderr are inherited, and the process is exposed in `Bun.sha.procs`.
+  Background pipelines, builtins, functions, and all redirections are rejected
+  before files are opened. General asynchronous command lists, job control,
+  and coprocesses are not implemented.
 - Brace command groups, `select`, arithmetic commands, and `[[ ... ]]` are
   not implemented.
 - Functions and subshells cover practical cases but do not yet reproduce every

package/initramfs/buninu/apps/bunmsh/help/README.md

@@ -959,7 +959,8 @@ Create hard or symbolic links.
 ### Usage
 
 ```sh
-ln [-sfT] TARGET LINK
+ln [-sf] TARGET LINK
+ln [-sf] TARGET ... DIRECTORY
 ```
 
 ### Options and forms
@@ -967,6 +968,7 @@ ln [-sfT] TARGET LINK
 - `-s`: Create a symbolic link.
 - `-f`: Replace an existing destination.
 - `-T`: Treat the destination as a normal path, not a directory.
+- Multiple targets may be linked into an existing directory.
 
 ### Example
 

package/initramfs/buninu/apps/bunmsh/help/ln.md

@@ -5,7 +5,8 @@ Create hard or symbolic links.
 ### Usage
 
 ```sh
-ln [-sfT] TARGET LINK
+ln [-sf] TARGET LINK
+ln [-sf] TARGET ... DIRECTORY
 ```
 
 ### Options and forms
@@ -13,6 +14,7 @@ ln [-sfT] TARGET LINK
 - `-s`: Create a symbolic link.
 - `-f`: Replace an existing destination.
 - `-T`: Treat the destination as a normal path, not a directory.
+- Multiple targets may be linked into an existing directory.
 
 ### Example
 

package/initramfs/buninu/apps/bunmsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunmsh",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Cross-platform command shell for Bun JavaScript",
   "license": "MIT",
   "type": "module",