Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/YangDai2003/OpenNote-Compose
Markdown editor and also note app for Android entirely based on Jetpack Compose.
https://github.com/YangDai2003/OpenNote-Compose
android clipboard compose editor education html jetpack latex-math markdown material-design mermaid-diagrams notes-app plaintext richtext txt university
Last synced: about 2 months ago
JSON representation
Markdown editor and also note app for Android entirely based on Jetpack Compose.
- Host: GitHub
- URL: https://github.com/YangDai2003/OpenNote-Compose
- Owner: YangDai2003
- License: gpl-3.0
- Created: 2024-03-20T15:15:17.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-04-13T14:00:47.000Z (5 months ago)
- Last Synced: 2024-04-14T01:14:04.210Z (5 months ago)
- Topics: android, clipboard, compose, editor, education, html, jetpack, latex-math, markdown, material-design, mermaid-diagrams, notes-app, plaintext, richtext, txt, university
- Language: Kotlin
- Homepage:
- Size: 89.2 MB
- Stars: 22
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
- [English](README.md)
- [简体中文](README.zh.md)
# OpenNote
OpenNote is a modern Android note-taking application built entirely with Compose.
It is developed using Kotlin (Compose) and follows the MVVM (Model-View-ViewModel) architecture
pattern along with Clean Architecture principles.
## How to Use OpenNote with Markdown, LaTeX Math, and Mermaid Diagrams?
You can know more about how to use OpenNote with Markdown, LaTeX Math, and Mermaid Diagrams in
the [Guide](Guide.md).
## Features
- **Create, Edit, and Delete Notes**: Users can create, edit, and delete notes effortlessly.
- **Create, Edit, and Delete Folders**: Organize notes efficiently with folder management
functionalities.
- **Sorting and Filtering**: Easily sort and filter notes and folders based on various criteria.
- **Move Notes**: Seamlessly move notes between different folders for better organization.
- **Trash Bin**: Safely move notes to the trash for temporary storage before permanent deletion.
- **OCR Text Recognition**: Utilizes ML Kit and CameraX for optical character recognition (OCR)
directly from images.
- **Markdown Support**: Supports both CommonMark and GitHub Flavored Markdown (GFM) syntax for
versatile formatting options.
- **LaTeX Math Support**: Supports LaTeX math syntax for mathematical equations.
- **Mermaid Diagram Support**: Supports Mermaid syntax for creating diagrams and flowcharts.
- **Rich Text Mode**: Offers a simplified writing experience with basic rich text editing
capabilities.
- **Export Options**: Notes can be exported in various formats including TXT, MD (Markdown), and
HTML for versatile sharing and usage.
- **Material 3 Design**: Adheres to Material Design guidelines for a modern and cohesive user
interface.
- **Responsive Design**: Optimized for devices with different screen sizes and orientations.
## Screenshots
## Technical Details
- **Programming Languages**: Kotlin
- **Build Tool**: Gradle with Kotlin DSL
- **Android Version**: The application targets Android SDK version 34 and is compatible with devices
running Android SDK version 29 and above.
- **Kotlin Version**: The application uses Kotlin version 2.0.0.
- **Java Version**: The application uses Java version 17.
## Architecture
- **MVVM (Model-View-ViewModel)**: Separates the user interface logic from the business logic,
providing a clear separation of concerns.
- **Clean Architecture**: Emphasizes separation of concerns and layers of abstraction, making the
application more modular, scalable, and maintainable.
## Libraries and Frameworks
- **Compose**: A modern toolkit for building native Android UI.
- **Hilt**: A dependency injection library for Android.
- **KSP (Kotlin Symbol Processing API)**: Enhances Kotlin compilation with additional metadata
processing.
- **Room**: A persistence library providing an abstraction layer over SQLite.
- **Compose Navigation**: Simplifies the implementation of navigation between screens.
- **Material Icons**: Provides Material Design icons for consistent visual elements.
- **ML Kit**: Utilized for OCR text recognition.
- **CameraX**: Used for custom camera functionality.
## Privacy Policy and Required Permissions
You can find the Privacy Policy and Required Permissions in the [Privacy Policy](PRIVACY_POLICY.md).
## Installation
To build and run this application, you need to install the latest version of Android Studio. Then,
you can clone this repository from GitHub and open it in Android Studio.
```bash
git clone https://github.com/YangDai2003/OpenNote.git
```
In Android Studio, select `Run > Run 'app'` to start the application.
## Contribution
Any form of contribution is welcome! If you find a bug or have a new feature request, please create
an issue. If you want to contribute code directly to this project, you can create a pull request.
## References
- [MaskAnim](https://github.com/setruth/MaskAnim): Implementation of the theme switching function
using mask animation.
## TODO
- [ ] Support WebDAV and Dropbox
- [ ] Add more preference settings
- [ ] Add in-note search function