# 🔮 CoreShell - Secure Cybernetic Terminal Deck

A Cyberpunk-Inspired SSH Manager for Android

Your gateway to the netrunner's underground

---

📸 Visual Overview

---

✨ Core Features

🖥️ Server Profile Manager

Configure and save your SSH nodes with custom parameters:

• Host, Port, and Username configuration
• Connection history and quick access
• Profile categorization and tagging

🌐 Tailscale Integration

Seamless support for Tailscale networks:

• Automatic network detection
• MagicDNS and 100.x.x.x IP support
• One-click VPN integration

🎨 Cyberpunk Aesthetics

Immersive retro-futuristic interface:

• CRT scanline effects and glow animations
• Neon-themed UI components
• Monospace typography for authentic terminal feel
• Animated transitions and visual feedback

💻 Advanced Terminal Shell

Interactive command execution with enhanced UX:

• Quick-access shortcuts for common commands (ls, htop, neofetch, etc.)
• Real-time command history
• Copy/paste functionality with Android clipboard integration

📂 SFTP File Explorer

Full-featured file management on remote servers:

• Browse remote directories with hierarchical view
• Download, upload, modify, and delete files
• File preview and metadata display
• Drag-and-drop support (where applicable)

🔐 RSA Key Manager (Keyring)

Enterprise-grade key management:

• Generate RSA-2048 key pairs
• Secure local storage in encrypted database
• Passwordless SSH authentication
• Key rotation and management utilities

📊 Real-time Telemetry Monitoring

Live system metrics visualization:

• CPU usage with oscilloscope-style graphs
• RAM consumption tracking
• System temperature monitoring
• Network traffic analysis with bandwidth gauges

📱 Home Screen Widget

Quick overview of server status:

• At-a-glance server health metrics
• One-tap connection launch
• Customizable widget layout

---

🛠️ Technology Stack

┌─────────────────────────────────────┐
│   Frontend & UI                     │
├─────────────────────────────────────┤
│ • Kotlin & Jetpack Compose          │
│ • Material 3 Design System          │
│ • Custom Cyberpunk Theme            │
│ • Canvas-based Graphics             │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│   Data & Persistence                │
├─────────────────────────────────────┤
│ • Room Database (encrypted)         │
│ • DataStore for preferences         │
│ • Secure SharedPreferences          │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│   Async & Reactive                  │
├─────────────────────────────────────┤
│ • Kotlin Coroutines                 │
│ • Flow & StateFlow                  │
│ • ViewModel & MVVM architecture     │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│   Networking & Integration          │
├─────────────────────────────────────┤
│ • Retrofit 2 for HTTP               │
│ • Moshi for JSON serialization      │
│ • OkHttp with interceptors          │
└─────────────────────────────────────┘

---

📱 Installation & Build

⚙️ Requirements

Component	Version
Android	7.0+ (API 24)
Android Studio	Ladybug or recent
Gradle	9.3.1+
Java/Kotlin	JDK 17+

🚀 Quick Build

Generate Release APK:

./gradlew assembleRelease

Output Location:

📦 app/build/outputs/apk/release/app-release.apk

Install to Device:

adb install app/build/outputs/apk/release/app-release.apk

Debug Build (Development):

./gradlew installDebug

---

🔒 Security & Privacy

CoreShell implements multiple security layers:

Feature	Description
Authentication	Password & RSA key-based SSH authentication
Encryption	Local private keys stored in encrypted Room database
Network	Tailscale VPN integration for secure transport
Permissions	Minimal Android permissions requested
Best Practices	No cleartext storage, secure communication protocols

🛡️ Security Recommendations

• Use RSA key authentication instead of passwords when possible
• Enable Tailscale for encrypted network tunneling
• Regularly rotate SSH keys
• Keep your Android device updated with latest security patches

---

📊 Architecture Overview

┌──────────────────────────────────────────────┐
│         UI Layer (Jetpack Compose)           │
├──────────────────────────────────────────────┤
│  Screens │ Components │ Themes │ Animations  │
└────────────────────┬─────────────────────────┘
                     │
┌────────────────────▼─────────────────────────┐
│        ViewModel & State Management          │
├──────────────────────────────────────────────┤
│    MVVM │ StateFlow │ Coroutines             │
└────────────────────┬─────────────────────────┘
                     │
┌────────────────────▼─────────────────────────┐
│     Repository & Data Access Layer           │
├──────────────────────────────────────────────┤
│    Room │ DataStore │ Remote APIs            │
└────────────────────┬─────────────────────────┘
                     │
┌────────────────────▼─────────────────────────┐
│      SSH/SFTP & System Services              │
├──────────────────────────────────────────────┤
│    Sessions │ File Transfer │ Telemetry      │
└──────────────────────────────────────────────┘

---

📝 Current Version Notes

⚠️ Important Information:

• The current version includes simulation engine for SSH/SFTP sessions and telemetry
• Integration with production SSH libraries (like JSch) is planned for upcoming releases
• UI/UX is production-ready; backend integration is in progress
• Feature parity with desktop SSH clients is the goal

---

🚀 Roadmap

• Full JSch SSH/SFTP implementation
• Multi-session support
• SSH port forwarding & tunneling
• Custom terminal themes
• Cloud backup for profiles
• Hardware key support
• Dark mode enhancements

---

🤝 Contributing

Contributions are welcome! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

👤 Author

PIXELQUADRO07

• GitHub: @PIXELQUADRO07

---

⚡ Built with ❤️ for the underground netrunner community

"In the darkness of the network, CoreShell is your light."