{"id":15039188,"url":"https://github.com/federicoiosue/omni-notes","last_synced_at":"2025-10-04T13:06:32.425Z","repository":{"id":12457686,"uuid":"15120144","full_name":"federicoiosue/Omni-Notes","owner":"federicoiosue","description":"Open source note-taking application for Android","archived":false,"fork":false,"pushed_at":"2024-10-07T06:14:14.000Z","size":55750,"stargazers_count":2693,"open_issues_count":184,"forks_count":1106,"subscribers_count":146,"default_branch":"develop","last_synced_at":"2024-10-29T15:45:08.900Z","etag":null,"topics":["android","crowdin","evernote","free","google","google-keep","java","note-taking","notebook","notes","omni-notes","open-source","play-store"],"latest_commit_sha":null,"homepage":"https://omninotes.app","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/federicoiosue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-12-11T21:59:18.000Z","updated_at":"2024-10-29T12:47:21.000Z","dependencies_parsed_at":"2022-07-13T01:10:27.082Z","dependency_job_id":"947d941b-446d-4e63-b9cd-3292fb920be6","html_url":"https://github.com/federicoiosue/Omni-Notes","commit_stats":null,"previous_names":[],"tags_count":150,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/federicoiosue%2FOmni-Notes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/federicoiosue%2FOmni-Notes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/federicoiosue%2FOmni-Notes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/federicoiosue%2FOmni-Notes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/federicoiosue","download_url":"https://codeload.github.com/federicoiosue/Omni-Notes/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217079,"owners_count":21066633,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","crowdin","evernote","free","google","google-keep","java","note-taking","notebook","notes","omni-notes","open-source","play-store"],"created_at":"2024-09-24T20:41:51.145Z","updated_at":"2025-10-04T13:06:32.416Z","avatar_url":"https://github.com/federicoiosue.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":" ![icon](assets/logo.png)\n\nOmni-Notes\n==========\n\n[![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![CI workflow](https://github.com/federicoiosue/Omni-Notes/workflows/CI/badge.svg)](https://github.com/federicoiosue/Omni-Notes/actions?query=workflow%3ACI)\n[![CodeQL Workflow](https://github.com/federicoiosue/Omni-Notes/workflows/CodeQL/badge.svg)](https://github.com/federicoiosue/Omni-Notes/actions?query=workflow%3ACodeQL)\n[![Sonarcloud Coverage](https://sonarcloud.io/api/project_badges/measure?project=omni-notes\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=omni-notes)\n[![Sonarcloud Maintainability](https://sonarcloud.io/api/project_badges/measure?project=omni-notes\u0026metric=sqale_rating)](https://sonarcloud.io/dashboard?id=omni-notes)\n[![Crowdin](https://d322cqt584bo4o.cloudfront.net/omni-notes/localized.png)](https://crowdin.com/project/omni-notes)\n[![GitHub release](https://badgen.net/github/release/federicoiosue/Omni-Notes)](https://github.com/federicoiosue/Omni-Notes/releases/latest)\n[![GitHub release](https://img.shields.io/github/downloads/federicoiosue/Omni-Notes/total?label=Github%20Downloads)](https://github.com/federicoiosue/Omni-Notes/releases)\n\nOmni-Notes is a note taking \u003cb\u003eopen-source\u003c/b\u003e application aimed to have both a \u003cb\u003esimple interface\u003c/b\u003e while keeping \u003cb\u003esmart\u003c/b\u003e behavior. This application expands on the generic note taking features of other basic applications and allows for users to attach image and video files, use a variety of widgets, tag and organize notes, search through notes, and customize the applications UI.\n\nThe project was inspired by the absence of such applications compatible with old phones and old versions of Android. It aims to provide an attractive look and follow the most recent design guidelines of the Google operating system that is not currently avaialbe for older devices.\n\n**Follow the developments and post your comments and advice on Telegram Community at https://t.me/omninotes**\n\nHelp to keep translations updated is always welcome, if you want give a hand checkout the translation project on *https://translate.omninotes.app.*\n\n\u003ca href=\"https://f-droid.org/repository/browse/?fdid=it.feio.android.omninotes.foss\" target=\"_blank\"\u003e\n\u003cimg src=\"https://f-droid.org/badge/get-it-on.png\" alt=\"Get it on F-Droid\" height=\"90\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://play.google.com/store/apps/details?id=it.feio.android.omninotes\" target=\"_blank\"\u003e\n\u003cimg src=\"https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png\" alt=\"Get it on Google Play\" height=\"90\"/\u003e\u003c/a\u003e\n\nIf you're willing to help speeding up developments please also opt-in for the Alpha version of the app following continuous delivery principles:\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=it.feio.android.omninotes.alpha\" target=\"_blank\"\u003e\n\u003cimg src=\"https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png\" alt=\"Get it on Google Play\" height=\"90\"/\u003e\u003c/a\u003e\n\n## Features\n\nCurrently the following functions are implemented:\n\n* \u003cb\u003eMaterial Design interface:\u003c/b\u003e Basic add, modify, archive, trash and delete notes actions\n* \u003cb\u003e Advanced Navigation and Sharing: \u003c/b\u003eShare, merge and search notes, Export/import notes to backup\n* \u003cb\u003e Media Attachments: \u003c/b\u003e Image, audio and generic file attachments\n* \u003cb\u003eOrganization: \u003c/b\u003eManage your notes using tags and categories\n* \u003cb\u003eSpecialty Features:\u003c/b\u003eTo-do list, Sketch-note mode, Google Now integration: just tell \"write a note\" followed by the content\n* \u003cb\u003e Widget Capabilities: \u003c/b\u003eMultiple widgets, DashClock extension, Android 4.2 lockscreen compatibility, Notes shortcut on home screen\n* \u003cb\u003e Internationalization: \u003c/b\u003eMultilanguage: 30+ languages supported: https://crowdin.com/project/omni-notes\n\n\nFuture Developments:\n\n* Notes sychronization\n* Web interface to manage notes ([stub project](https://github.com/federicoiosue/omni-notes-desktop))\n\nYou can find a complete changelog inside the application settings menu!\n\nIf you need some help on how to use the application you'll find everything you need in the [Help Online](assets/help/help.md) section.\n\n[![Promo video](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/promo_video_thumb.png)](https://youtu.be/0Z_-SgT3qYs \"Promo video\")\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/02.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/03.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/04.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/05.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/06.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/07.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/08.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/09.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/10.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/11.png)\n![](https://raw.githubusercontent.com/federicoiosue/Omni-Notes/develop/assets/play_store_pics/12.png)\n\n## User guide\n\nLook into the wiki for GIFs-based tutorials: [LINK](https://github.com/federicoiosue/Omni-Notes/wiki)\n\n## Build\n\nWatch the following terminal session recording on how to compile distributable files or follow the instructions below\n[![asciicast](https://asciinema.org/a/102898.png)](https://asciinema.org/a/102898)\n\nBuild instructions:\n* Enter your computer's terminal\n* Clone the application by using the link to the repository (https://github.com/federicoiosue/Omni-Notes), this will take a couple minutes\n* Enter the Omni-Notes folder using the command $cd Omni-Notes\n* Check that the branch is up to date by using the command $git status\n* Enter the command $export ANDROID_HOME=/home/fede/Android/Sdk (for Windows $set ANDROID_HOME=/home/fede/Android/Sdk)\n* Enter the command $./gradlew assemble\n* Allow a couple minutes for the application to build.\n* View the outputs of the build using the command $ls -l omniNotes/build/outputs/apk\n\n\nTo be sure that build environment is fully compliant with the project the following command creates a container with all the needed tools to compile the code:\n\n```\ncd {project-folder}; rm local.properties; docker rm android-omninotes; docker run -v $PWD:/workspace --name android-omninotes tabrindle/min-alpine-android-sdk:latest bash -c \"mkdir -p ~/.android \u0026\u0026 touch ~/.android/repositories.cfg \u0026\u0026 yes | sdkmanager --update \u0026\u003e/dev/null \u0026\u0026 cd /workspace \u0026\u0026 ./gradlew clean build --stacktrace -Dorg.gradle.daemon=true -Pandroid.useDeprecatedNdk=true\"\n\n```\n\n## Test\n\nTo execute all tests included into the project connect a device or emulator, then run the following command:\n\n```shell\n./gradlew testAll\n```\n\n### Testing Pyramid\n\nTo speedup the development more levels of testing are available following the [testing pyramid approach](https://martinfowler.com/articles/practical-test-pyramid.html), each type test requires more time than the previous one.\n\n### Unit Tests\n```shell\n./gradlew --stacktrace test\n```\n\n### Integration Tests\n```shell\n./gradlew --stacktrace -Pandroid.testInstrumentationRunnerArguments.notAnnotation=androidx.test.filters.LargeTest connectedAndroidTest\n```\n\n### UI Tests\n```shell\n./gradlew --stacktrace -Pandroid.testInstrumentationRunnerArguments.annotation=androidx.test.filters.LargeTest connectedPlayDebugAndroidTest\n```\nNotice that in this case I specified a single flavor to run tests on. This could be a useful and faster approach when you're testing specific flavor features.  \n\n## Mentioned on\n\n[XDA](https://www.xda-developers.com/omni-notes-the-open-source-note-app/)\n[Android Authority](https://www.androidauthority.com/best-note-taking-apps-for-android-205356/)\n[Addictive Tips](https://www.addictivetips.com/android/note-taking-apps-for-android/)\n[Techalook](https://techalook.com/apps/best-sticky-notes-android-iphone/)\n[DZone](https://dzone.com/articles/amazing-open-source-android-apps-written-in-java)\n[Slash Gear](https://www.slashgear.com/best-note-taking-apps-for-android-phones-and-tablets-04529297/)\n[quaap.com](https://quaap.com/D/use-fdroid)\n[Freeappsforme.com](https://freeappsforme.com/productivity-apps-android-ios-2017)\n\n## Developed with love and passion by\n\n* Federico Iosue - [Website](https://federico.iosue.it)\n* [Other contributors](https://github.com/federicoiosue/Omni-Notes/graphs/contributors)\n\n## License\n\n\n    Copyright 2013-2025 Federico Iosue\n    \n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n    \n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n    \n    You should have received a copy of the GNU General Public License\n    along with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedericoiosue%2Fomni-notes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffedericoiosue%2Fomni-notes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedericoiosue%2Fomni-notes/lists"}