# 🔮 CoreShell - Secure Cybernetic Terminal Deck
A Cyberpunk-Inspired SSH Manager for Android
Your gateway to the netrunner's underground
Configure and save your SSH nodes with custom parameters:
- Host, Port, and Username configuration
- Connection history and quick access
- Profile categorization and tagging
Seamless support for Tailscale networks:
- Automatic network detection
- MagicDNS and 100.x.x.x IP support
- One-click VPN integration
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
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
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)
Enterprise-grade key management:
- Generate RSA-2048 key pairs
- Secure local storage in encrypted database
- Passwordless SSH authentication
- Key rotation and management utilities
Live system metrics visualization:
- CPU usage with oscilloscope-style graphs
- RAM consumption tracking
- System temperature monitoring
- Network traffic analysis with bandwidth gauges
Quick overview of server status:
- At-a-glance server health metrics
- One-tap connection launch
- Customizable widget layout
┌─────────────────────────────────────┐
│ 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 │
└─────────────────────────────────────┘
| Component | Version |
|---|---|
| Android | 7.0+ (API 24) |
| Android Studio | Ladybug or recent |
| Gradle | 9.3.1+ |
| Java/Kotlin | JDK 17+ |
Generate Release APK:
./gradlew assembleReleaseOutput Location:
📦 app/build/outputs/apk/release/app-release.apk
Install to Device:
adb install app/build/outputs/apk/release/app-release.apkDebug Build (Development):
./gradlew installDebugCoreShell 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 |
- 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
┌──────────────────────────────────────────────┐
│ 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 │
└──────────────────────────────────────────────┘
- 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
- 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
Contributions are welcome! Please follow these guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
PIXELQUADRO07
- GitHub: @PIXELQUADRO07
