v0.3.0

Rio 0.3.0 is a major release with a ground-up rewrite of the rendering architecture, including a new GPU-accelerated Metal backend on macOS, a completely new tab and split panel system powered by Taffy layout, and features like Kitty/Sixel graphics, command palette, and trail cursor effects. With this level of change, rough edges are expected — if you run into bugs, please report them at https://github.com/raphamorim/rio/issues and they'll be addressed as quickly as possible.

For Windows users, feel free to use 0.3.0 but I'd recommend waiting for the next release, which will include significant improvements and stability
fixes for the platform.

Happy Easter!

Changelog

• Quit Confirmation Dialog: New in-window quit screen with Rio logo, triggered by Cmd+Q / confirm-before-quit
  • Respond with y to quit or n to cancel
  • Optional native macOS quit dialog via window.macos-use-quit-dialog config
• Kitty Graphics Protocol: Display images directly in your terminal
  • Direct placements (U=0)
  • Virtual placements (U=1)
  • Diacritic-based row/column encoding (283 combining characters)
  • RGB color encoding for image/placement IDs (24+8 bit support)
  • Virtual placement rendering (infrastructure complete, rendering pending)
• Sixel Graphics: Full support with proper scrolling and positioning
• Graphics Rendering Improvements:
  • Fixed vertical positioning alignment
  • Fixed scrolling (images persist when origin scrolls off-screen)
  • Fixed duplicate rendering with per-frame deduplication
  • LRU cache with automatic eviction
• Native Metal Support (macOS): Hardware-accelerated rendering with Metal
• New GPU-Rendered Navigation: Faster, smoother tab interface
• Command Palette: Quick access to terminal functions
• Toggle Appearance Theme: Switch between dark and light themes at runtime via key binding (ToggleAppearanceTheme) or command palette (only available when adaptive theme is configured)
• Custom Mouse Cursor: Configurable mouse cursor effects via effects.custom-mouse-cursor
• Trail Cursor: Smooth spring-animated cursor trail using neovide-style physics (enabled by default via effects.trail-cursor)
• Desktop Notifications: Support for OSC 9 (iTerm2) and OSC 777 (rxvt) terminal notifications using native platform APIs (macOS UNUserNotificationCenter, Linux D-Bus, Windows Toast)
• Force Theme: New force-theme configuration property to override the system theme when using adaptive themes
• macOS Traffic Light Positioning: Customize position of window control buttons
  • Configure via macos-traffic-light-position-x and macos-traffic-light-position-y
  • Defaults to standard macOS positioning (11.4, 16.1)
  • Not available in Tab navigation mode
• OSC 9;4 Progress Bar Support: Terminal progress indicator (ConEmu/Windows Terminal compatible)
• Scroll Bar: Overlay scroll bar that appears on scroll and fades out after 2s
  • Works per-panel in split views
  • Draggable thumb with click-on-track jump scrolling
  • Configure via enable-scroll-bar (enabled by default)
• Tab Title RELATIVE_PATH variable: New template variable that shows a home-relative shortened path (e.g. ~/Documents/a/rio or …/a/psone/starpsx). Default tab title on macOS/Linux changed to {{ TITLE || RELATIVE_PATH }}.
• Wgpu now is always f32.
  • This fixes non arm chip macos use cases.

Breaking Changes

• Navigation modes simplified - if you use TopTab, BottomTab, or Bookmark, change to:

  [navigation]
  mode = "Tab"

• Default Decorations changed to Transparent on macOS (was Enabled)
• Removed: TopTab, BottomTab, and Bookmark navigation modes
• Available modes: Plain, Tab, NativeTab (macOS only)
• Tab color configuration simplified: Removed tabs-foreground, tabs-active-foreground, and tabs-active-highlight
  • Use tabs for inactive tab text and border color (default: #cccccc)
  • Use tabs-active for active tab text color (default: #ffffff)
• The old padding api became margin:

  # It will apply margin rules to the main container
  # CSS-Like
  margin = [10] # (10px to all)
  margin = [10, 5] # (top and bottom margin are 10px, right and left margin are 5px)
  margin = [10, 5, 15, 20] # (top margin is 10px, right margin is 5px, bottom margin is 15px, left margin is 20px)
  
  # It will apply margin rules to panels
  [panel]
  margin = [5] # (5px to all)
  row-gap = 0 # (0px)
  column-gap = 0 # (0px)

Technical Details

• Complete rendering architecture rewrite for GPU-based UI
• Parser now supports APC sequences for Kitty graphics protocol
• Removed legacy layer/quad rendering system
• Added Metal backend for macOS, split WebGPU backend for cross-platform
• New kitty_virtual module for placeholder encoding
• Graphics cleanup with LRU eviction strategy (evicts up to 5 oldest when atlas full)
• Added 5 unit tests for graphics rendering (positioning, LRU, deduplication)

v0.2.37

• Support window bg color via OSC.
• Fix vi cursor not displayed when moving.
• Fix font loader for fallbacks and extra.
• Fix font size updating through config.

Commits

• d8a9919 update vi cursor fix
• bf5ae3b fix: Fix vi cursor updates, can be improved
• 489c1e8 allow ununsed on bg_color
• d4352c4 set windows title bar
• 1924db3 few updates to it work correctly
• 54610a5 set screen and window background color when changed via OSC
• 34b2ddd fix lint
• 0db0a2a use memmap2 and check all faces
• 17e3f99 simplify comments
• 2eeeb7b fix decode names manually with utf-16
• e691825 Merge branch 'main' into fix-font-fallback
• facb362 Fix changelog URL (#1388)
• 6330dcf fix font size updating through config
• 22bc971 attempt to load path on memory retrival
• 5366fe6 flake.lock: Update (#1384)
• 88d9f67 flake.lock: Update (#1372)
• 0b0265b update lockfile
• 20a3378 update deps
• faadea0 flake.lock: Update (#1367)
• ee3545e Avoid allocating in pre_exec closure (#1366)
• e54ceed update com.rioterm.Rio.metainfo.xml (0.2.36)

v0.2.36

Changelog

• 5027ae5 fix lint for atlas.rs
• 6ba19b4 prepare 0.2.36
• b4d5007 flake.lock: Update (#1364)
• c0d687a fix: handler should process two intermediate bytes in CSI sequences (#1363)
• ab26ffd flake.lock: Update (#1356)
• 1b65c18 update changelog
• ad9eb8c flake.lock: Update (#1353)
• 2c6b11b fix DECSCUSR
• dc57083 update xml for flatpak
• 14e9f6e actually update changelog to declare it's only macos for now

v0.2.35

• GPU memory usage drop 83%.
• Sync input render logic (macos).

Changelog

• ce76aa2 prepare v0.2.35
• d00f39c correct memory usage on changelog.md
• ebd5704 don't panic
• eed71da reduce gpu memory
• 4415d9e present_after_input

v0.2.34

• Fix issue for finding fonts introduced with the v0.2.33 new font loader.

Changelog

• 7741fb7 update the lockfile
• 23edd1a prepare v0.2.34
• b79a112 rewrite font loader to fix queries
• a835bd4 Revert "update linux deps"
• d1d09e8 guess who is back, old fontloader
• 5fc7cf1 update misc with metainfo.xml
• 5ac66db mark as released

v0.2.33

• Platform-specific configuration improvements #1341:
  • Added support for platform-specific environment variables via env-vars field in platform config
  • Platform-specific env-vars are now appended to global env-vars instead of replacing them
  • Fixed configuration inheritance: platform overrides now use field-level merging instead of replacing entire sections
  • Window, Navigation, and Renderer settings can now be partially overridden per platform without duplicating all fields
  • Added theme field to platform config for per-platform theme selection
  • Shell configuration continues to use complete replacement for simplicity
• Fix ScrollPageUp and ScrollPageDown actions not working in custom keybindings #1275.
• Fix Noticeably slower startup compared to wezterm, foot #1346.
• Fix Font loader taking a LOT of time to load fonts #1339.
• Fix Rio panics on launch on a Raspberry Pi 5 #1332.
• Fix kitty keyboard protocol.
• Support reporting terminal version via XTVERSION.

Changelog

• 303e1a1 update linux deps
• caa8646 format the code
• 841137b update lockfile
• 32b34a2 update changelog
• f26aa6d add ScrollPageUp & ScrollPageDown actions (closes #1275)
• ac7d9d1 platform: support env-vars for platform and better merge (closes #1341)
• db807b2 update changelog
• 4191f5c improve get_optimal_texture_sample_type
• f54333e let's make things easier
• 6cf7609 prepare 0.2.33
• 6d5e092 update changelog
• d91b3ee todo fix wasm32 on loader
• 1722cd3 remove comment
• d884977 lock versions on toml;2C
• 1aa1905 fix lint
• 3628142 migrate loader
• 66e685a fix keyboard protocol
• d0e1fd5 format XTVERSION test
• 9eb0f6f test xtversion report
• d9f5a84 feat: add XTVERSION support (#1347)
• 9cfe704 flake.lock: Update (#1344)
• 6873bf7 in fact TEXTURE_FORMAT_16BIT_NORM should be available for f16 otherwise is too misleading
• c1498c9 try full f16 features at first
• d3194f5 remove .helix/languages.toml as this repo avoids try to setup configuration for multi editors
• 0bb5b7f Update nix files (#1319)
• f91340a flake.lock: Update (#1336)
• 87d93e4 oopsie
• 2807f05 fix docs md
• b26b841 changelog moved from /docs/changelog to /changelog
• 066d100 address 'Dimension X value 4096 exceeds the limit of 2048'

v0.2.32

• Updated WGPU to v27.0.1.
• Fix No backend are enabled on FreeBSD #1235.

Changelog

• 8d6e12a prepare 0.2.32
• b7a9d93 update changelog
• 2d5a909 update wgpu to latest
• 480b6d8 docs: 'split' color option (#1330)
• 3a33266 flake.lock: Update (#1329)
• 1aa7c06 flake.lock: Update (#1326)
• 21aa7a9 update examples on dividers movement
• 34c0a31 docs(website): fix capitalization in the top banner (#1318)
• 39edcd5 flake.lock: Update (#1313)
• 4a38b3a update deps
• 55e038c update rio metainfo xml

v0.2.31

• Update Rust to v1.90.
• Fix kitty keyboard recognition.
• Breaking: Simplified key binding escape sequences
  • Replaced separate text and bytes fields with a single esc field
  • Escape sequences are now sent directly to the PTY without text manipulation
  • Migration: Replace bytes = [27, 91, 72] with esc = "\u001b[H"
  • Migration: Replace text = "some text" with esc = "some text"
  • Example: { key = "l", with = "control", esc = "\u001b[2J\u001b[H" } to clear screen
• Fix key binding conflicts: Resolved issues where keys like PageUp, PageDown, and Alt+Enter required explicit "None" bindings before they could be reassigned
  • Simplified binding conflict resolution logic to automatically remove conflicting default bindings
  • User-defined bindings now always take precedence without requiring placeholder "None" entries

Changelog

• 02dc881 prepare 0.2.31
• 3bd2bf3 upadte persy https://gitlab.com/persy/persy/-/issues/79
• 5f09cd8 tests for keyboard mode
• 7cfd5f7 fix kitty keyboard mode stack logic (#1309)
• df89495 cleanup will_finish_launching
• 530d1ca implement NSAutoFillHeuristicControllerEnabled from ghostty made
• c607449 update skrifa
• 4b671dc update docs to use changelog instead of releases
• b8a4e9c fix theme logic retrival (closes #1039)
• 2a1de13 use get instead of get_mut for UpdatConfig
• 391b3bd fix adaptative theme not being computed on update config (closes #1039)
• 1c9776c Fix theme reloading issue when editing configuration
• b2bcf48 update dependencies
• de80726 update the releases.md
• 80930c5 use trigger_match to ensure user bindings always take precedence
• 368368e flake.lock: Update (#1305)
• 0806f31 clone only action per binding for
• c632f04 update docs
• 2f5eeb7 refactor to send_write
• 0c71bf6 fix send_write
• a3630d7 wip allow esc
• 02a14c3 update makefile to use cargo publish --workspace, perk of rust 1.90
• 773f12e update rust to v1.90
• af14ba6 flake.lock: Update (#1299)
• 9da31e2 update flatpak xml file
• 3ea4350 update release.md

v0.2.30

• Fix Debian/Ubuntu package installation: Resolved terminfo conflicts with system packages #1264
  • Debian (.deb) packages no longer include terminfo files to avoid conflicts with ncurses-term
  • Users on Ubuntu 22.04 and older need to manually install terminfo after package installation
  • Debian 13+ and Ubuntu 24.04+ users get terminfo from system's ncurses-term package
  • RPM packages continue to include terminfo as before
• Add audible & visual bell support #1284.

Changelog

• ab8b2a5 prepare 0.2.30
• 0d5a3d5 revert to old stroke but fixing limits
• dc85bf6 Merge branch 'fix-diagonal'
• 0c6590d update DiagonalRisingBar DiagonalCross and DiagonalFallingBar (ref: #1297)
• 48d88b7 fix DiagonalRisingBar calculation
• 58fdc9d flake.lock: Update (#1296)
• 1b5c90a flake.lock: Update (#1292)
• 88eca6b fix debian conflicts with ncurses-term (#1287)
• 7fb3971 update releases.md
• 6c6931e docs: Update releases.md with bell support feature
• 1967b19 Add audible & visual bell support (#1284)
• 7f387a9 flake.lock: Update
• 6cb8ab7 fix lint
• 92950bb update frontends/rioterm/src/context/mod.rs
• e049107 add calculate_selection_damage_impl
• 1ebcd1b Update sugarloaf/src/font/mod.rs
• 3300a50 Merge branch 'main' into pr-1282
• 3b12c2d fix characters become invisible at very large sizes (closes #1268)
• 37cd0ef fix lint
• 644983a Improve font cache implementation with DashMap
• 6632a44 fix Accidental inversion of bool
• 37fb0b1 Don't copy data as much; use more SharedData
• a7be7cb Clear FONT_DATA_CACHE when fonts are changed
• c202394 Update to rust 1.89
• 07b4a5a update com.rioterm.Rio.metainfo.xml

v0.2.29

Changelog

• 126cd31 update deps
• ec583cb docs: update releases.md with recent fixes
• b962da8 flake.lock: Update
• 2c03db9 fix blinking cursor (closes #1269)
• 1e1acbd fix Rio uses UNC (?) path as working directory, breaking Neovim subprocesses
• 6557e7e add NSCameraUseContinuityCameraDeviceType to plist
• eb9fe5f update com.rioterm.Rio.metainfo.xml