Repository navigation
Releases
ram-tui v1.0.3-1 — Maintenance & Installer Hardening
🛡️ RAM-TUI v1.0.3-1 — Maintenance & Installer Hardening
This maintenance release adds atomic installer protections and official visual branding assets.
Highlights
- Atomic Installer Downloads (C-501):
install.shandinstall.ps1now download to isolated temporary files and atomically move the binary only after cryptographic SHA-256 verification succeeds, preventing symlink overwrite / TOCTOU issues. - Official Brand Assets: Added transparent header logo (
assets/logo.png), high-res project avatar (assets/avatar.png), and documented brand iconography inREADME.md. - Audit Verification: Full workspace passing 71 automated tests with zero-allocation, safe FFI, and hardened signal handling certified.
Quick Install
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bashram-tui v1.0.3 — Security Hardening, Fail-Closed Installers & Visual Polish
🚀 RAM-TUI v1.0.3 — Maintenance & Hardening Release
This maintenance release hardens terminal escape safety, upgrades bootstrap installers to fail-closed cryptographic verification, refines Windows swap telemetry, optimizes the render loop, and resolves visual border alignment in the Theme Selector modal.
🛡️ Security & Hardening Fixes
-
Sanitized Hostname Against Terminal Escape Injection:
- Consolidated system hostname extraction into
core_render::format::get_hostname(). - The live TUI header now sanitizes raw
HOSTNAME/COMPUTERNAMEenvironment values throughsanitize_text(), stripping ANSI escape sequences, control bytes, and Unicode directional overrides. - Added unit test
test_get_hostname_sanitized.
- Consolidated system hostname extraction into
-
Strict Fail-Closed Installer Checksum Verification:
- Updated both
install.shandinstall.ps1to be strictly fail-closed: if the release.sha256digest cannot be retrieved, or hashing utilities are absent, or checksum verification fails, the installer aborts immediately with an error and cleans up the binary instead of continuing unverified.
- Updated both
-
Input Sanitization on
--filterCLI Argument:- Enforced the printable ASCII allowlist (
' '..='~') on the startup--filterflag, matching the live interactive search box and preventing terminal escape injection through wrapper scripts.
- Enforced the printable ASCII allowlist (
🐛 Bug Fixes & Architectural Enhancements
-
Theme Selector Modal Border Alignment:
- Fixed a visual glitch where right borders (
│) on theme selection rows were shifted by 8 characters due to static space counts. - All rows now dynamically calculate exact column width via
visible_cell_width()and pad to the 38-column box width. - Centered and dynamically padded the modal footer key navigation legend.
- Added regression test
test_theme_modal_box_alignmentverifying box width consistency across all 13 themes.
- Fixed a visual glitch where right borders (
-
Real Windows Pagefile Swap Telemetry:
- Replaced hardcoded
swap_used = 0on Windows with accurate committed memory differentialcommit_as.saturating_sub(total).min(swap_total).
- Replaced hardcoded
-
Render Loop Performance & Code Deduplication:
- Cached TrueColor
Palettestate across frames, eliminating ~10-20 heap string allocations per frame on unchanged ticks. - Reused
FrameBuffer::prevvector capacity withclear()+extend_from_slice()instead of cloning every line. - Unified tick-loop and post-keypress rendering call sites into a single macro.
- Wired
FrameBuffer::invalidate()to trigger on terminal window resize and display mode switches.
- Cached TrueColor
📦 Quick Install / Upgrade
Linux & macOS
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iexram-tui v1.0.2 — Maintenance Release (PSS/USS Fix & Cryptographic Integrity)
🚀 RAM-TUI v1.0.2 — Maintenance Release
🐛 Bug Fixes & Enhancements
-
PSS/USS Candidate Pre-Sorting:
- Resolved an issue in
collector/src/processes.rswhere process candidate sampling forsmaps_rollupPSS/USS enrichment occurred prior to sorting the process vector. - The candidate pool is now pre-sorted by RSS before sampling, guaranteeing that the top memory consumers are consistently enriched with exact PSS and USS telemetry.
- Added unit test
test_rss_presort_candidate_enrichmentverifying top-process enrichment.
- Resolved an issue in
-
Process Count Range Validation:
- Enforced range constraint
1..=10000on the--count/-ncommand-line argument, matching documented specifications and preventing zero-count edge cases. - Added integration test
test_count_range_enforcement.
- Enforced range constraint
-
Cryptographic SHA-256 Installer Verification:
- Automated CI generation and upload of
.sha256checksum digests for all precompiled binary assets. - Both
install.shandinstall.ps1now automatically download and verify the binary SHA-256 digest before marking as executable.
- Automated CI generation and upload of
-
Hotkey Documentation:
- Formally documented
x/XalongsideKfor process termination in keybindings tables.
- Formally documented
📦 Quick Install / Upgrade
Linux & macOS (One-Line Installer)
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iexCargo (From Source)
cargo install --git https://github.com/BlackFeather-git/ram-tui.gitram-tui v1.0.1 — Automated Multi-Platform Release Assets
🚀 RAM-TUI v1.0.1 — Maintenance Release
📦 Automated Multi-Platform Binary Assets
This release introduces automated CI release builds and publishes standalone precompiled binary assets for all major operating systems and architectures directly on GitHub Releases:
- Linux x86_64:
ram-tui-linux-x86_64 - macOS Apple Silicon (aarch64 / M-series):
ram-tui-darwin-aarch64 - macOS Intel (x86_64):
ram-tui-darwin-x86_64 - Windows x86_64:
ram-windows-x86_64.exe(andram-tui-windows-x86_64.exe)
🛠️ Installer Improvements
- Windows PowerShell (
install.ps1): Added HTTP error handling, basic parsing, and binary size verification to ensure failed downloads fail with explicit diagnostic feedback rather than capturing error HTML. - Universal POSIX (
install.sh): Added-fsSLcurl flag and asset download failure guards.
📦 Quick Install / Upgrade
Linux & macOS (One-Line Installer)
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iexCargo (From Source)
cargo install --git https://github.com/BlackFeather-git/ram-tui.gitram-tui v1.0.0 - Official Stable Release
🚀 RAM-TUI v1.0.0 — Official Stable Release (Native Rust Engine)
🦀 The Ground-Up Rust Rewrite
RAM-TUI v1.0.0 is a complete, ground-up rewrite in pure, native Rust with zero external runtime dependencies. It delivers sub-millisecond execution latency, deep kernel telemetry, flicker-free rendering, and honest multi-platform support across Linux, macOS, and Windows.
✨ Key Features & Architecture
- Deep Kernel Telemetry: Real-time physical RSS, Proportional Set Size (PSS via
smaps_rollup), and Unique Set Size (USS) tracking with single-pass procfs traversal. - Container Boundary Awareness: Native Linux Cgroups v2 (
/sys/fs/cgroup/memory.max) and Cgroups v1 limit detection for Docker, Podman, and Kubernetes workloads. - Multi-Platform Native Backends:
- Linux: Zero-subprocess
/prockernel parsing with race-freepidfdsignaling. - macOS (Darwin): Direct Mach kernel FFI (
host_statistics64) and libproc process enumeration. - Windows: Win32
GlobalMemoryStatusEx, PSAPIK32GetProcessMemoryInfo, and native console event polling.
- Linux: Zero-subprocess
- Double-Buffered Frame Diffing: Custom
FrameBufferflushes only modified terminal cells and rows to stdout, eliminating terminal flicker. - 13 TrueColor Gradient Palettes: Live TrueColor RGB color themes with real-time in-memory cycling (
t/T). - Live 60-Second Sparkline: Dynamic spread calculation rendering fluid historical trend glyphs (
g). - Interactive Process Tree: Collapse and expand process groups live with hierarchical child PIDs.
📦 Installation & Upgrade
Linux & macOS (One-Line Installer)
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iexCargo (From Source)
cargo install --git https://github.com/BlackFeather-git/ram-tui.git🛡️ Verified Automated Test Suite
- 67 / 67 automated workspace tests passed across Linux (
ubuntu-latest), macOS (macos-latest), and Windows (windows-latest). - Strict Clippy linted with zero warnings (
-D warnings).
Note: RAM-TUI v1.0.0 is the official stable baseline. Feature development is frozen; maintenance and stability patches only.
ram-tui v0.7.0 - Stable Release
What's New in v0.7.0
Aesthetic & UI Engine
- Centered 6-Line Large Block ASCII Banner: Added prominent 6-line block ASCII title art (
RAM-TUI), perfectly centered on top and dynamically colorized with the active theme gradient on spacious viewports (>=22rows,>=60cols). - Curated Multi-Stop TrueColor Palettes Across All 13 Themes: Re-engineered palettes and gradients for all 13 built-in themes to match official community specifications (Catppuccin Mocha, Dracula Pro, Tokyo Night, Nord Arctic, Gruvbox Dark, Cyberpunk 2077, Rosé Pine, Everforest, Kanagawa Wave, Monokai Pro, Solarized Dark, and Monochrome).
- Midnight Velvet & Neon Lavender Default Theme: Introduced vibrant cyber-violet default palette with Electric Violet (
#7030EF) -> Neon Purple (#A846FF) -> Vivid Fuchsia (#DB1FFF) -> Light Lilac (#E0B3FF) gradient. - Visual Theme Showcase Gallery: Expanded documentation with pixel-perfect terminal previews for all 13 built-in themes in
assets/themes/. - Dynamic 2D Window Centering: Centered layout in both horizontal and vertical dimensions on large terminals.
Security & Release Infrastructure
- Mandatory Authenticated Installer Trust Chain: Upgraded
install.sh(Linux/macOS) andinstall.ps1(Windows) to strictly enforce mandatory SHA-256 integrity checks and maintainer RSA-2048 PKCS#1 v1.5 digital signature verification (ram.sig) before file installation (fail-closed). - Reproducible Release Tag Pinning: Supported immutable release tag pinning via
RAM_INSTALL_TAG/REFacross Unix and Windows installers. - Cryptographic In-Place Self-Updater: Built-in self-updater (
ram --update) with RSA-2048 root of trust, AST validation, and atomic executable replacement. - Python 3.8+ Compatibility Baseline: Formally updated runtime baseline to Python 3.8+ across Linux, macOS, and Windows.
- Automated CI Matrix: 52 automated tests passing 100% green across 12 cross-platform matrix jobs.
ram-tui v0.6.1
ram-tui v0.6.1 — Stable Release
Small enough to understand. Accurate enough to trust. Fast enough to leave running.
Highlights in v0.6.1
- Trademark RAM-TUI Branding Header: Elevated title header to bold
RAM-TUIacross all interactive and mini display modes (RAM-TUI · hostname · Linux x86_64 · theme). - Dynamic 2D Window Centering: Automatically centers the entire dashboard in both dimensions (horizontal and vertical) on wide and tall viewports with dynamic padding, preventing header clocks and divider rules from stretching or sticking to window edges.
- 50 Automated Cross-Platform Tests: Added
test_window_vertical_and_horizontal_centeringverifying 2D padding and bounds across Python 3.8 through 3.13 on Linux, macOS, and Windows. - Cryptographic Self-Updater (
ram --update): Fail-closed in-place updates verified against embedded maintainer RSA-2048 public key, SHA-256 digests, and AST validation. - 50ms Real-Time Fluid Refresh: Sub-millisecond differential cursor rendering (<0.3ms/frame) with <0.6% single-core CPU overhead.
- 13 Built-in 24-bit TrueColor Themes: Live runtime cycling (
t) withdefault,dracula,catppuccin,nord,tokyo-night,gruvbox,cyberpunk,rose-pine,everforest,kanagawa,monokai,solarized, andmonochrome.
Verification & Checksums
| Asset | SHA-256 Checksum |
|---|---|
ram |
1d416da515722507c4f0296e73a162344c774a1d7f09a4d0274ee4b29a44c773 |
# Verify checksum
sha256sum -c ram.sha256Quick Install
# Linux & macOS
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iexram-tui v0.6.0
ram-tui v0.6.0 — Stable Release
Small enough to understand. Accurate enough to trust. Fast enough to leave running.
Highlights
- Cryptographic Self-Updater (
ram --update): Fail-closed in-place updates verified against embedded maintainer RSA-2048 public key, SHA-256 digests, and AST validation. - 50ms Real-Time Fluid Refresh: Sub-millisecond differential cursor rendering (<0.3ms/frame) with <0.6% single-core CPU overhead.
- Dynamic Horizontal Centering: Automatically centers the TUI on wide monitors without stretched divider lines or displaced clocks.
- Terminal Resize Reflow Protection:
SIGWINCHsignal handling and per-line\033[K(Erase to End of Line) clear to eliminate resize ghost artifacts. - Zero External Dependencies: 100% standard library implementation across Linux, macOS, and Windows.
- 13 Built-in 24-bit TrueColor Themes: Live runtime cycling (
t) withdefault,dracula,catppuccin,nord,tokyo-night,gruvbox,cyberpunk,rose-pine,everforest,kanagawa,monokai,solarized, andmonochrome. - 4 Display Modes:
hero(full dashboard),--compact(meters only),--mini(single bar), and--tiny(status bars for Waybar/tmux).
Verification & Checksums
| Asset | SHA-256 Checksum |
|---|---|
ram |
5e57aa7b27357e3e2e2bf70136bbc7f3fc13eb02158184050fefca4f71101f1f |
# Verify checksum
sha256sum -c ram.sha256Quick Install
# Linux & macOS
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex