You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This little application provides a way on scanning handwritten notes and printed documents.
7
-
8
-
It automatically detect the edge of the paper over a contrastant surface.
22
+
OpenNoteScanner is an open-source application that provides a way to scan handwritten notes and printed documents using your mobile device.
9
23
10
-
When using the [printed special page template](https://github.com/ctodobom/OpenNoteScanner/raw/master/Page%20Templates/A4%20with%202%20pages.pdf) it automatically detects the QR Code printed on the bottom right corner and scans the page immediately.
24
+
### Features
11
25
12
-
After the page is detected, it compensates any perspective from the image adjusting it to a 90 degree top view and saves it on a folder on the device.
26
+
* Automatic edge detection of documents on contrasting surfaces.
27
+
* Perspective correction to a 90-degree top-down view.
28
+
* Support for a [printed special page template](https://github.com/ctodobom/OpenNoteScanner/raw/master/Page%20Templates/A4%20with%202%20pages.pdf) with a QR code for instant scanning.
29
+
* Ability to launch from other applications requesting images.
30
+
* Organize scanned documents in a local gallery.
31
+
* Export scans as a PDF or share as an image.
13
32
14
-
It is also possible to launch the application from any other application that asks for a picture, just make sure that there is no default application associated with this action.
Because of the version of OpenCV that is used in the project it needs to run on Android 5.0 (lollipop) or newer.
43
+
- Due to the version of OpenCV that is used, this project requires Android 5.0 (lollipop) or newer to run.
34
44
35
-
In order to capture and manipulate images Open Note Scanner depends on having the OpenCV Manager application installed. If not installed Open Note Scanner will ask to download it from https://github.com/ctodobom/OpenCV-3.1.0-Android or from Google Play Store.
45
+
- In order to capture and manipulate images, Open Note Scanner depends on having the OpenCV Manager application installed.
46
+
- If not installed, Open Note Scanner will ask to download it from https://github.com/ctodobom/OpenCV-3.1.0-Android or from the Google Play Store.
36
47
37
48
38
49
How to Install
39
50
--------------
40
51
41
-
Open Note Scanner is available for simplified installation on[Google Play Store](https://play.google.com/store/apps/details?id=com.todobom.opennotescanner), from [Amazon App Store](http://www.amazon.com/Claudemir-Todo-Bom-Open-Scanner/dp/B01EUAU924) and also from [F-Droid Android Open Source Repository](https://f-droid.org/repository/browse/?fdid=com.todobom.opennotescanner).
52
+
Open Note Scanner is available for simplified installation from[Google Play Store](https://play.google.com/store/apps/details?id=com.todobom.opennotescanner), from [Amazon App Store](http://www.amazon.com/Claudemir-Todo-Bom-Open-Scanner/dp/B01EUAU924) and also from [F-Droid Android Open Source Repository](https://f-droid.org/repository/browse/?fdid=com.todobom.opennotescanner).
42
53
43
54
[<imgalt="Get it on Google Play"height="60"src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" />](https://play.google.com/store/apps/details?id=com.todobom.opennotescanner&utm_source=global_co&utm_medium=prtnr&utm_content=Mar2515&utm_campaign=PartBadge&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1)[](https://f-droid.org/repository/browse/?fdid=com.todobom.opennotescanner)
44
55
45
56
**Disclaimer:** Google Play version is ad-supported.
46
57
47
-
Binary APK file is available [directly from GitHub in the releases section](https://github.com/ctodobom/OpenNoteScanner/releases)of the project.
58
+
Binary APK file is available directly from the [releases section](https://github.com/ctodobom/OpenNoteScanner/releases)on GitHub.
48
59
49
-
Instructions for building
60
+
Usage
61
+
-----
62
+
For detailed usage instructions, please refer to the [FAQ](FAQ.md).
63
+
64
+
Building from Source
50
65
-------------------------
51
66
52
67
### Android Studio
53
68
54
-
Import the project from GitHub using File -> New -> Project from Version Control -> GitHub, fill the URL https://github.com/ctodobom/OpenNoteScanner.git
55
-
56
-
It will ask for a base directory, normally AndroidStudioProjects, you can change it to your preference.
57
-
58
-
After this the Open Note Scanner can be built.
59
-
69
+
1. Import the project from GitHub using File -> New -> Project from Version Control -> GitHub, enter the URL https://github.com/ctodobom/OpenNoteScanner.git
70
+
2. Choose the base directory (usually AndroidStudioProjects, but you can change it to your preference).
If you're new to open-source, we recommend you to checkout our [_Contributing Guidelines_](https://github.com/ctodobom/OpenNoteScanner/blob/master/CONTRIBUTING.md) and [Setup Guidelines](https://github.com/ctodobom/OpenNoteScanner/blob/master/SETUP_GUIDELINES.md). Feel free to fork the project and send us a pull request.
93
+
Contributions are always welcome! If you're new to open-source, please check our [Contributing Guidelines](https://github.com/ctodobom/OpenNoteScanner/blob/master/CONTRIBUTING.md) and [Setup Guidelines](https://github.com/ctodobom/OpenNoteScanner/blob/master/SETUP_GUIDELINES.md). Feel free to fork the project and submit pull requests.
82
94
83
95
History
84
96
-------
85
97
86
-
I've started this app on a brazilian holyday "extended weekend" based on the fact that I was unable to find any open source application that does this job. I was mainly inspired on the RocketBook Wave closed source application.
98
+
I started this app while on a brazilian holiday (that is, an "extended weekend") based on the fact that I was unable to find any open source application that does this job. I was mainly inspired by the RocketBook Wave closed source application.
87
99
88
-
I really do not know if I will extend more the application, but I am writing bellow some objectives to make it better.
100
+
I really do not know if I will extend the application more, but I have written some objectives below on how to make it better.
89
101
90
102
Roadmap
91
103
-------
92
104
93
-
*enhance the image gallery of scanned documents
94
-
*register a share action in order to obtain documents already pictured through standard camera apps
95
-
*implement automatic action based on the RocketBook Wave marking of the page
105
+
*Enhance the image gallery of scanned documents.
106
+
*Register a share action in order to obtain documents already pictured through standard camera apps.
107
+
*Implement an automatic action based on the RocketBook Wave marking of the page.
96
108
97
109
Donations
98
110
---------
@@ -101,34 +113,28 @@ My job is on enterprise servers administration and some development consulting.
101
113
102
114
For being part of open source projects and documenting my work here I really do not charge anything. I am trying to avoid any type of ads also.
103
115
104
-
If you think that any information you obtained here is worth of some money and are willing to pay for it, feel free to send any amount through paypal or bitcoin.
116
+
If you think that any information you obtained here is worth of some money and are willing to pay for it, feel free to send any amount through PayPal or Bitcoin.
In order to fund the development of Open Note Scanner, since version 1.0.36 when downloaded from Google Play store the app will show ads on some screens and will also allow for donation through Google Play in-app purchase. There is no difference on the features available from Google Play version and F-Droid releases.
111
-
112
-
113
-
Contributing
114
-
------------
115
-
116
-
If you have any idea, feel free to fork it and submit your changes back to me.
122
+
In order to fund the development of Open Note Scanner, since version 1.0.36 when downloaded from Google Play Store the app will show ads on some screens and will also allow for donation through Google Play in-app purchase. There is no difference on the features available from Google Play version and F-Droid releases.
117
123
118
-
Thanks
124
+
Acknowledgements
119
125
------
120
126
121
127
### Contributors
122
128
123
-
As an open source application, contribution are always welcome.
129
+
As an open source application, contributions are always welcome.
124
130
125
-
Most translations contributions are listed on [CONTRIBUTORS.md file](https://github.com/ctodobom/OpenNoteScanner/blob/master/CONTRIBUTORS.md) and code contributors are listed on [the Changelog file](https://github.com/ctodobom/OpenNoteScanner/blob/master/CHANGELOG.md) and [the commits history](https://github.com/ctodobom/OpenNoteScanner/commits)
131
+
Most translation contributions are listed in the [CONTRIBUTORS.md](https://github.com/ctodobom/OpenNoteScanner/blob/master/CONTRIBUTORS.md)file and code contributors are listed on [the Changelog file](https://github.com/ctodobom/OpenNoteScanner/blob/master/CHANGELOG.md) and the [commits history](https://github.com/ctodobom/OpenNoteScanner/commits)
126
132
127
-
Other people helped submitting [Issue Reports](https://github.com/ctodobom/OpenNoteScanner/issues) and giving info through the [Telegram Group](https://t.me/OpenNoteScanner). Their help is appreciated as well.
133
+
We also thank those who have submitted [Issue Reports](https://github.com/ctodobom/OpenNoteScanner/issues) and provided feedback through the [Telegram Group](https://t.me/OpenNoteScanner).
128
134
129
135
### External code
130
136
131
-
This application wouldn't be possible without the great material produced by the community. I would like to give special thanks to the authors of essencial parts I've got on the internet and used in the code:
137
+
This application wouldn't be possible without the great material produced by the community. Special thanks to the authors of these essential components:
*[Android Hive / Full Screen Image pager](http://www.androidhive.info/2013/09/android-fullscreen-image-slider-with-swipe-and-pinch-zoom-gestures/)
@@ -141,9 +147,7 @@ License
141
147
142
148
Copyright 2016 - Claudemir Todo Bom
143
149
144
-
Software licensed under the GPL version 3 available in GPLv3.TXT and
145
-
online onhttp://www.gnu.org/licenses/gpl.txt.
150
+
This software is licensed under the GPL version 3, which can be found in the file GPLv3.TXT in this repository and
151
+
online athttp://www.gnu.org/licenses/gpl.txt.
146
152
147
-
Use parts from other developers, sometimes with small changes,
148
-
references on autorship and specific licenses are on individual
149
-
source files.
153
+
Some parts of this software use code from other developers. References to the original authors and specific licenses can be found in the individual source files.
0 commit comments