Skip to content

ByteSculptor07/QuilloNotes

Repository files navigation

Quillo

Hey👋 Thank you for your interest in Quillo!

Quillo is a handwriting notes app for Android, developed to provide a smooth handwriting experience. The core features of the app — such as writing, syncing and organizing your notes — already work well. However, the app is still under active development, so some features aren't implemented yet (such as exporting single pages instead of the entire notebook). To create a fully functional app, I need help. If you'd like to contribute, even if it's just a small improvement, you're more than welcome!

🛠️ Features

Quillo provides you with multiple tools, such as a pencil, a highlighter, a laser, a lasso and a path tool.

You can use the laser to present your notes, move parts around with the lasso and draw smooth paths with the path tool.

If you have some documents, you can import them into your notes — whether they're digital (like PDFs) or analog and scanned with the built-in scanner. If you want to share a note, you can export it as a PDF.

If you often lose your notes, this is for you! With Quillo, you can sync your notes with Dropbox for free, so that you won't lose any notes anymore. Even if you don't have access to your device right now, you can view all your notes on any other device, too!

To organize your notes, you can create folders and customize their colors and add expressive icons.

Multitasking is also no problem with Quillo. You can easily open multiple notes and switch between them without any delay, so you can stay productive and well-structured — even if you have a lot of work.

Your notebooks are also flexible. With the integrated page sorter, you can easily rearrange your pages, delete them or add new ones.

🖼️ Screenshots

🛫 Getting Started

Install the pre-built app

You can go to download Version 0.1 of the app here and install it on your device to test it. If you want to contribute, you should build the app from source.

Build the app from source

1. Clone the repository

git clone https://github.com/ByteSculptor07/QuilloNotes.git

2. Open the project in Android Studio.

3. Build and run it on your device or emulator


Note

For security reasons, the Dropbox App Key is not included in the source code. You'll need to create your own.

Enable Dropbox sync

To sync your notes using Dropbox, you need to obtain a Dropbox API Key.

1. Create a new app on the Dropbox app console

2. Enter information

  • Choose "Scoped access"
  • Choose "App folder"
  • Enter "Quillo" as the app name
  • Click "Create app"

3. Set Permissions

  • Go to the "Permissions"-tab
  • Choose "files.metadata.write" and "files.metadata.read"
  • Choose "files.content.write" and "files.content.read"
  • Click "Submit"

4. Copy the App Key

5. Set App Key in the app

Create a file called keystore.local in the project root with the content DROPBOX_KEY=<your-key-here>. Make sure to replace with your actual Dropbox key.

Warning

Do NOT commit your API Key to the repository.

🤝 Contribution

Firstly, thank you for your interest in contributing to this project!

The app is still in an early stage of development. Many features I have planned aren't implemented yet and of course, there are bugs. So any help is welcome, whether it's a new feature or just fixing a typo.

Note

If you'd like to contribute, check out CONTRIBUTING.md.

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.

🙏 Credits

Quillo wouldn't be possible without these awesome open source libraries and tools:

Many thanks to all library authors! 💙

Also, special thanks to Phosphor Icons for the awesome icons!