mirror of
https://github.com/litruv/lit.ruv.wtf.git
synced 2026-07-24 02:36:02 +10:00
Litruv
4be791f90e
- New xterm.js-based terminal with retro CRT aesthetics - Matrix chat integration with real-time messaging - Bluesky social media integration - Interactive commands (help, about, chat, bluesky, privacy, etc.) - Responsive design with mobile support - Privacy policy command - Quick navigation links (Docs, GitHub, Bluesky) - Preserved all image assets (blocks, items, particles, icons) - Updated README and package.json with new features
123 lines
3.3 KiB
Markdown
123 lines
3.3 KiB
Markdown
# lit.ruv.wtf
|
|
|
|
Interactive terminal interface for lit.ruv.wtf - A retro-styled command line experience with chat, documentation, and more.
|
|
|
|
## Features
|
|
|
|
- **Classic CRT Aesthetics**: Green phosphor terminal with authentic CRT effects including scanlines and subtle flicker
|
|
- **Interactive Chat**: Matrix-powered chat integration with real-time messaging
|
|
- **Keyboard Navigation**: Full keyboard support with arrow keys, history navigation, and standard terminal shortcuts
|
|
- **Mouse Support**: Click to position cursor, scroll through history, and interact with links
|
|
- **Responsive Design**: Works seamlessly on desktop, tablet, and mobile devices
|
|
- **Multiple Color Schemes**: Switch between green, amber, blue, and white phosphor themes
|
|
- **Command History**: Navigate through previous commands using up/down arrows
|
|
- **Bluesky Integration**: Fetch and display recent posts from Bluesky
|
|
- **Quick Links**: Easy access to documentation, GitHub, and social media
|
|
|
|
## Getting Started
|
|
|
|
### Quick Start
|
|
|
|
1. Open `index.html` directly in your browser, or
|
|
2. Serve with a local web server:
|
|
|
|
```bash
|
|
# Using Python 3
|
|
python3 -m http.server 8000
|
|
|
|
# Or using npm script
|
|
npm start
|
|
|
|
# Or using Node.js http-server
|
|
npx http-server -p 8000
|
|
```
|
|
|
|
3. Open `http://localhost:8000` in your browser
|
|
|
|
## Available Commands
|
|
|
|
- `help` - Display available commands
|
|
- `about` - Information about this terminal
|
|
- `clear` - Clear the terminal screen
|
|
- `echo [message]` - Echo back your message
|
|
- `date` - Display current date and time
|
|
- `whoami` - Display current user information
|
|
- `history` - Show command history
|
|
- `color [scheme]` - Change terminal color scheme (green, amber, blue, white)
|
|
- `banner` - Display welcome banner
|
|
- `bluesky [count]` - Fetch recent posts from Bluesky (default: 5)
|
|
- `chat` - Enter interactive chat (type /quit to exit)
|
|
- `github` - Visit GitHub repository
|
|
- `contact` - Display contact information
|
|
- `privacy` - Display privacy policy
|
|
|
|
## Chat Commands
|
|
|
|
While in chat mode (after running `chat`):
|
|
|
|
- `/help` - Show chat commands
|
|
- `/nick [name]` - Change your display name
|
|
- `/quit` or `/exit` - Exit chat mode
|
|
|
|
## Keyboard Shortcuts
|
|
|
|
- `↑/↓` - Navigate command history
|
|
- `←/→` - Move cursor within current line
|
|
- `Home` - Move cursor to start of line
|
|
- `End` - Move cursor to end of line
|
|
- `Ctrl+C` - Cancel current input
|
|
- `Ctrl+L` - Clear screen (keeping current input)
|
|
- `Enter` - Execute command
|
|
- `Backspace` - Delete character
|
|
|
|
## Mouse Support
|
|
|
|
- Click anywhere in the terminal to focus
|
|
- Scroll to view terminal history
|
|
- Click on links to open them
|
|
|
|
## Customization
|
|
|
|
### Colors
|
|
|
|
Change the color scheme by editing the theme in `terminal.js` or use the `color` command at runtime:
|
|
|
|
```
|
|
$ color amber
|
|
$ color blue
|
|
$ color white
|
|
$ color green
|
|
```
|
|
|
|
### Commands
|
|
|
|
Add new commands by extending the `commands` object in `terminal.js`:
|
|
|
|
```javascript
|
|
commands.mycommand = {
|
|
description: 'My custom command',
|
|
execute: (args) => {
|
|
return 'Output from my command';
|
|
}
|
|
};
|
|
```
|
|
|
|
## Technologies
|
|
|
|
- **xterm.js** - Terminal emulator for the web
|
|
- **xterm-addon-fit** - Responsive terminal sizing
|
|
- **xterm-addon-web-links** - Clickable URL support
|
|
- **Pure CSS** - Classic CRT effects and animations
|
|
|
|
## Browser Support
|
|
|
|
Works in all modern browsers:
|
|
- Chrome/Edge 90+
|
|
- Firefox 88+
|
|
- Safari 14+
|
|
- Opera 76+
|
|
|
|
## License
|
|
|
|
MIT
|