Skip to content

johnsideserf/rem

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rem

Docs

REMOTE ENTRY MODULE -- Weyland-Yutani Corp. Standard-Issue File Navigation Terminal

Classified under WY-DOC-4789. Unauthorized access is a violation of ICC corporate law.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@...........@@@@...........@@@@..........@@@@...........@@@@...........@@@@@
@@@@@@@...........@@@@.......@@@@..............@@@@.......@@@@...........@@@@@@@
@@@@@@@@@...........@@@@...@@@@..................@@@@...@@@@...........@@@@@@@@@
@@@@@@@@@@@...........@@@@@@........................@@@@@@...........@@@@@@@@@@@
@@@@@@@@@@@@@...........@@.............@@.............@@...........@@@@@@@@@@@@@
@@@@@@@@@@@@@@.......................@@..@@.......................@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@..................@@......@@..................@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@..............@@@..........@@@..............@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@..........@@@@..........@@@@..........@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
              W E Y L A N D - Y U T A N I  C O R P O R A T I O N
                       BUILDING  BETTER  WORLDS

A corporate-grade terminal file navigator built in Rust with ratatui. Designed for operatives who need to manage filesystem assets efficiently in hostile or low-bandwidth environments. Three CRT display profiles are provided to match your installation's hardware specifications.

Screenshots

Boot sequence

Phosphor Green -- Ship Terminal

Phosphor Green theme

Amber -- Colony Terminal

Amber theme

Corporate Cyan -- Executive Terminal (with theme picker)

Corporate Cyan theme with theme picker

Operator Manual

Terminal Capabilities

  • Navigation -- vim-keyed traversal (hjkl), jump-to-top/bottom (gg/G), smooth animated transitions
  • Dual-pane operations -- Ctrl+W to toggle split-view, Tab to switch panes
  • Visual targeting -- v to enter selection mode, mark multiple assets with j/k
  • Asset management -- yy copy, dd cut, p paste, D purge (requires confirmation)
  • Bulk rename -- R in visual mode for find/replace pattern renaming across selections
  • Fuzzy search -- / to locate assets in the current directory via pattern matching
  • Recursive search -- ? to search across all subdirectories
  • Jump keys -- Space to display single-key target labels on all visible entries
  • Navigation marks -- m + key to designate a waypoint, ' + key to return
  • Asset preview -- side panel with syntax-highlighted, scrollable file contents
  • In-app editor -- e to edit files with syntax highlighting, undo stack, and save
  • Rename & provision -- r to rename, o to create file, O to create directory
  • Sort modes -- s to cycle between name, size, and date ordering
  • Git integration -- current branch and dirty status displayed in header
  • Nerd Font icons -- extension-based file icons with fallback for standard terminals
  • Symbol sets -- 7 swappable glyph styles via theme picker (Standard, ASCII, Block, Minimal, Pipeline, Braille, Scanline)
  • System telemetry -- ` to monitor CPU, RAM, disk, and network diagnostics with braille sparklines
  • CPU-driven heartbeat -- header heartbeat speeds up proportionally to CPU load when telemetry is active
  • Network uplink indicator -- animated braille glyph in the header tied to real-time network throughput
  • Display profiles -- t to open the theme and symbol set selector
  • Sidebar adjustment -- [ / ] to resize the sidebar panel
  • File integrity -- # to compute SHA-256 hash of selected file
  • Disk usage -- W to scan recursive directory size allocation
  • Archive browsing -- inspect zip/tar contents as a virtual read-only directory
  • Lock screen -- L to activate per-palette animated screensaver with braille art, configurable timeout and enable/disable
  • Boot sequence -- per-palette corporate authentication splash with animated WY mark
  • Per-palette throbbers -- 5 throbber types (DataStream, Processing, Heartbeat, Scanning, Idle) with unique frame sets per display profile
  • COMMS INTERCEPT -- 100+ lore-accurate messages across 5 channels (Corporate, USCM, Deep Space, Synthetic, Science) surface during idle periods
  • COMMS feed selector -- C to open channel tuner, subscribe to RSS/Atom feeds, add custom messages, configurable via config.toml
  • Distress signal screensaver -- after extended idle, a pulsing braille SOS distress beacon with fake coordinates replaces the standard screensaver
  • CRT warm-up -- phosphor ramp-up animation before boot sequence, simulating CRT cathode heating
  • I/O waveform -- real-time braille oscilloscope in telemetry panel driven by CPU load and network throughput
  • Per-theme telemetry animations -- radar sweep (green), seismograph (amber), Conway's Game of Life cellular automaton (cyan) alongside network telemetry
  • Header ticker -- scrolling Weyland-Yutani corporate messages in header bar, configurable via config.toml
  • Animated file type badges -- executables, config files, and encrypted assets pulse with per-palette badge animations
  • Multi-tab workspaces -- Ctrl+N to open new tab, Alt+Left/Alt+Right to switch, :close to dismiss
  • Session persistence -- workspace state (directories, panes, sort mode, panel layout) saved automatically between sessions
  • Filesystem watcher -- live directory reloading when external processes modify the current directory
  • Git staging integration -- Ctrl+G to stage/unstage files, :git commit, status badges [+]/[M]/[?] in file list
  • File comparison -- :diff for side-by-side file diff with color-coded additions and removals
  • Preview minimap -- Ctrl+M to toggle braille minimap in preview pane with viewport indicator
  • Batch glob operations -- :rm, :cp, :mv with glob patterns for bulk file operations
  • Pipe to external tools -- | <cmd> to filter file list through external commands, > <file> to export
  • Frecency smart bookmarks -- frequently visited directories ranked by visit recency in sidebar

Display Profiles

Profile Designation Deployment CRT Effects
PHOSPHOR GREEN WY-CRT-01 Ship terminals (Nostromo, Sulaco) Scan line shimmer, phosphor persistence trail
AMBER WY-CRT-02 Colony terminals (Hadley's Hope) Signal degradation, character corruption, glitch lines
CORPORATE CYAN WY-CRT-03 Executive consoles, MedPods Rare thermal flicker, cursor bloom

Each profile includes unique throbber animations (radar/seismograph/diamond scanning indicators, signal ping/warning strobe/access pulse idle throbbers), per-palette braille sparklines in telemetry, themed boot sequences, and unique telemetry animations (radar sweep, seismograph, Conway's Game of Life).

Command Reference

Navigation

Input Function
h / Left Ascend to parent directory
l / Right / Enter Enter directory
j / Down Cursor down
k / Up Cursor up
gg Jump to first entry
G Jump to last entry
Ctrl+O Navigate back in history
Ctrl+I Navigate forward in history
Ctrl+U / Ctrl+D Half-page scroll up / down
- Ascend to parent directory

Search & Targeting

Input Function
/ Fuzzy search current directory
? Recursive search across subdirectories
Space Deploy jump key overlay
m + key Set navigation mark
' + key Jump to navigation mark
M + key Delete navigation mark

Asset Operations

Input Function
yy Copy current asset or selection
dd Cut current asset or selection
p Paste from operations buffer
D Purge selection (confirmation required)
r Rename asset
R Bulk rename (visual mode -- find/replace)
o Provision new file
O Provision new directory
e Open in-app text editor
E Open in external $EDITOR
# Compute SHA-256 hash
W Scan disk usage recursively

Sorting

Input Function
s Cycle sort mode (name / size / date)

Selection

Input Function
v Toggle visual targeting mode
u Clear all marks

Git Staging

Input Function
Ctrl+G Toggle stage/unstage current file

Tabs

Input Function
Ctrl+N Open new tab
Alt+Left / Alt+Right Switch to previous / next tab

Display & Panels

Input Function
Ctrl+W Toggle dual-pane mode
Tab Switch active pane / cycle right panel
Ctrl+J / Ctrl+K Scroll preview pane down / up
Ctrl+M Toggle preview minimap
[ Contract sidebar
] Expand sidebar
t Open display profile / symbol set selector
` Toggle telemetry readout
H Toggle hidden assets
L Lock screen (activate screensaver)

General

Input Function
q Terminate session
Esc Abort current operation

MU-TH-UR Command Mode (:)

Input Function
:q Terminate session
:cd <path> Navigate to directory
:close Close current tab
:set hidden / nohidden Toggle hidden files
:set minimap / nominimap Toggle preview minimap
:set screensaver / noscreensaver Toggle screensaver
:set screensaver_timeout=N Set screensaver timeout in seconds
:comms Open COMMS channel selector
:comms <channel> Set COMMS channel (all/corporate/uscm/deepspace/synthetic/rss/custom)
:sort name|size|date Set sort mode
:theme green|amber|cyan Switch display profile
:symbols <variant> Switch symbol set
:rm <glob> Remove files matching glob pattern
:cp <glob> <dest> Copy files matching glob pattern
:mv <glob> <dest> Move files matching glob pattern
:diff <file1> <file2> Side-by-side file comparison
:git status Show git status
:git add Stage current file
:git reset Unstage current file
:git commit <msg> Commit staged changes
:| <cmd> Filter file list through external command
:| clear Clear pipe filter
:> <file> Write file list or preview to file
:help Show available commands

Deployment

Quick install

cargo install --path .

Build from source

git clone https://github.com/johnsideserf/rem.git
cd rem
cargo build --release
./target/release/rem

System Requirements

  • Rust 2024 edition (1.85+)
  • Terminal with Unicode rendering capability
  • Recommended: a Nerd Font for optimal glyph display

Disclaimer

This software is an independent fan creation and is not affiliated with, endorsed by, or associated with 20th Century Studios, the Walt Disney Company, or the creators of the Alien franchise. "Weyland-Yutani," "Nostromo," "Sulaco," "MU-TH-UR," "LV-426," "Building Better Worlds," and all related names, references, and fictional lore are trademarks and copyrighted properties of their respective owners. All franchise references are used purely as creative homage in a transformative, non-commercial fan work.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).


Building Better Worlds.

About

Phosphor CRT-aesthetic file navigator TUI built with ratatui

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages