# sshapp

**Repository Path**: seeventh/sshapp

## Basic Information

- **Project Name**: sshapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SSH Client Project

A modern Android SSH client application built with Kotlin and Jetpack Compose.

## Features

- **SSH Connection Management**: Connect to remote servers via SSH
- **Terminal Emulation**: Full terminal experience with ANSI support
- **Authentication**: Support for password and public key authentication
- **Key Management**: Generate and import SSH keys securely stored in Android Keystore
- **Connection Profiles**: Save and manage multiple server configurations
- **Material Design 3**: Modern, beautiful UI following Material Design guidelines
- **Dark Theme**: Support for light and dark themes

## Tech Stack

- **Language**: Kotlin
- **UI**: Jetpack Compose + Material Design 3
- **Architecture**: MVVM + Clean Architecture
- **Dependency Injection**: Hilt
- **SSH Library**: Apache Mina SSHD
- **Database**: Room
- **Secure Storage**: EncryptedSharedPreferences + Android Keystore

## Project Structure

```
app/src/main/java/com/sshclient/
├── core/
│   ├── di/           # Hilt dependency injection modules
│   └── service/      # Background services
├── data/
│   ├── local/        # Local data sources (Room, SharedPreferences)
│   ├── remote/       # Remote data sources (SSH client)
│   └── repository/   # Repository implementations
├── domain/
│   ├── model/        # Domain models
│   ├── repository/   # Repository interfaces
│   └── usecase/      # Use cases
└── presentation/
    ├── ui/           # Compose UI components
    ├── viewmodel/    # ViewModels
    └── theme/        # Theme configuration
```

## Build & Run

### Requirements

- Android Studio Hedgehog (2023.1.1) or newer
- JDK 17
- Android SDK 34
- Minimum SDK 24 (Android 7.0)

### Steps

1. Clone the repository
2. Open in Android Studio
3. Sync Gradle files
4. Run on emulator or physical device

```bash
./gradlew assembleDebug
```

## Security Features

- Private keys encrypted using Android Keystore
- EncryptedSharedPreferences for sensitive data
- No cleartext network traffic allowed
- Biometric authentication support for key access
- Secure key deletion

## Roadmap

- [ ] SFTP file transfer
- [ ] Port forwarding (local, remote, dynamic)
- [ ] Multiple simultaneous sessions
- [ ] Session logging
- [ ] Command snippets library
- [ ] Hardware keyboard support
- [ ] Widget for quick connect
- [ ] Mosh protocol support

## License

MIT License

## Credits

Built with:
- [Apache Mina SSHD](https://mina.apache.org/sshd-project/)
- [Jetpack Compose](https://developer.android.com/jetpack/compose)
- [Hilt](https://dagger.dev/hilt/)
- [Room](https://developer.android.com/training/data-storage/room)