Skip to content

nikita-popov/notum

Repository files navigation

notum

License: MIT Kotlin Android

A standalone, offline-first note-taking app for Android with optional synchronization to Memos servers.

⚠ Work in Progress
This project is in early development stage. Features are being actively developed and the API may change.

Features

  • Fully Offline - Works completely without internet connection or server
  • Optional Sync - Connect to Memos server if you want cloud backup
  • Background Sync - Automatic synchronization with Memos server using WorkManager
  • Modern UI - Built with Jetpack Compose and Material 3 design
  • Theme Support - Light, dark, and system theme modes
  • Multi-Language - Localization support
  • Material You - Dynamic color theming on Android 12+

Use Cases

Standalone Mode

Use notum as a simple, privacy-focused note-taking app without any server. All your notes stay on your device.

Sync Mode

Optionally connect to a Memos server to:

  • Backup your notes to the cloud
  • Sync across multiple devices
  • Access notes from web interface

Installation

From Source

  1. Clone the repository:
git clone https://github.com/nikita-popov/memos-client.git
cd memos-client
  1. Open the project in Android Studio Ladybug or later
  2. Build and run the project on your device or emulator

From Releases

Binary releases will be available soon

Configuration

On first launch, you'll need to configure your Memos server connection:

  1. Open Settings from the main screen
  2. Enter your Memos server URL (e.g., https://memos.example.com)
  3. Provide your authentication credentials
  4. Save settings and sync will start automatically

Building

Debug Build

./gradlew assembleDebug

Release Build

./gradlew assembleRelease

Roadmap

  • Markdown support
  • Search and filtering memos
  • Tags management
  • Resources (images, files) support
  • Widget support
  • Export/Import memos
  • Conflict resolution for sync
  • Multiple account support

Known Issues

  • Background sync may not work reliably on some devices with aggressive battery optimization
  • Large memo synchronization not yet optimized

Contributing

Contributions are welcome!
Since I'm relatively new to Kotlin and Android development, any help, suggestions, or code reviews are greatly appreciated.

License

Memos Client is open-source software licensed under the MIT License.

Acknowledgments

  • Memos - The amazing memo service this client is built for
  • Jetpack Compose - Modern Android UI toolkit

Disclaimer

This is an unofficial client for Memos.
It is not affiliated with or endorsed by the official Memos project.

About

Offline-first notes app with optional sync with Memos https://github.com/usememos/memos

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages