Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hadiagdam/blackboxchat-android
A privacy-focused messaging app for Android, offering end-to-end encryption and multiple PIN-protected inboxes.
https://github.com/hadiagdam/blackboxchat-android
aes-encryption android e2e-encryption encryption jetpack-compose kotlin
Last synced: about 1 month ago
JSON representation
A privacy-focused messaging app for Android, offering end-to-end encryption and multiple PIN-protected inboxes.
- Host: GitHub
- URL: https://github.com/hadiagdam/blackboxchat-android
- Owner: HadiAgdam
- Created: 2024-10-29T17:50:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-15T16:57:45.000Z (about 2 months ago)
- Last Synced: 2024-12-15T17:40:03.391Z (about 2 months ago)
- Topics: aes-encryption, android, e2e-encryption, encryption, jetpack-compose, kotlin
- Language: Kotlin
- Homepage:
- Size: 208 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BlackBox
**BlackBox** is a privacy-focused messaging app for Android that prioritizes security and simplicity. Built using **Jetpack Compose**, this app offers end-to-end encryption (E2EE), multiple PIN-protected inboxes, and a custom-designed SQLite database structure for efficient and scalable data management.
---
## Features
- **End-to-End Encryption**: Ensures secure communication with cryptographic techniques.
- **Multiple Inboxes**: Each protected by its own PIN, allowing separation of conversations.
- **Custom SQLite Database Structure**: A unique approach to define tables and manage queries programmatically.
- **Jetpack Compose**: Built with Compose, modernizing UI development on Android.
---
## Tech Stack
- **Kotlin**: The programming language for the app.
- **Jetpack Compose**: For building the user interface.
- **SQLite**: For local database storage, with a custom implementation for flexibility and scalability.
---
## SQLite Database Design
The app includes a novel way of interacting with the database using interfaces and helper functions for consistency and maintainability. Here’s a glimpse of the implementation:
```kotlin
interface Column {
val columnName: String
val definition: String
}
fun ContentValues.put(key: Column, text: String) =
this.put(key.columnName, text)
fun ContentValues.put(key: Column, bool: Boolean) =
this.put(key.columnName, bool)
fun ContentValues.put(key: Column, long: Long) =
this.put(key.columnName, long)
```
### Table Definitions
Tables are defined programmatically, with `enum` classes representing the schema:
```kotlin
enum class InboxColumns(override val definition: String) : Column {
INBOX_ID("INTEGER PRIMARY KEY AUTOINCREMENT"),
INBOX_PUBLIC_KEY("TEXT NOT NULL UNIQUE"),
INBOX_PRIVATE_KEY("TEXT NOT NULL"),
LABEL("TEXT"),
HAS_NEW_MESSAGE("BOOLEAN"),
IV("TEXT"),
SALT("TEXT"),
LAST_MESSAGE_ID("INTEGER DEFAULT 0");
override val columnName: String = name.lowercase()
}
```
This design allows for queries to be generated dynamically:
```kotlin
fun generateWhereQuery(where: HashMap?): String {
return where?.let { w -> "WHERE (${w.keys.joinToString(" AND ") { column -> "${column.columnName} = ?" }})" } ?: ""
}
```
---
## Object-Oriented and Beyond
The app’s logic relies heavily on Kotlin’s advanced features, including encapsulation and helper methods. Some examples include `Pin` class, designed for validation and secure operations:
### Pin Class
```kotlin
class Pin private constructor(private val text: String) {
companion object {
const val LENGTH = 6
fun parse(text: String): Pin? {
return if (isValid(text)) Pin(
Sha256.hash(text)
)
else null
}
private fun isValid(text: String): Boolean = text.isDigitsOnly() && text.length == LENGTH
}
override fun toString() = text
}
```
---
## Challenges and Learning
This is my **first app using Jetpack Compose**, and I’m actively learning through the development process.
---
## Future Plans
- Add more advanced cryptographic features.
- Introduce synchronization across devices.
- Enhance the UI/UX for PIN-protected inbox management.
- Use right structure for viewmodel
- Implement flow and live data
---
## Contributions
Contributions and suggestions are welcome! Feel free to fork this repository or open an issue.