{"id":13478357,"url":"https://github.com/flxzt/rnote","last_synced_at":"2025-05-12T11:17:06.456Z","repository":{"id":37239887,"uuid":"393045142","full_name":"flxzt/rnote","owner":"flxzt","description":"Sketch and take handwritten notes.","archived":false,"fork":false,"pushed_at":"2025-05-10T12:19:59.000Z","size":268152,"stargazers_count":9663,"open_issues_count":348,"forks_count":359,"subscribers_count":58,"default_branch":"main","last_synced_at":"2025-05-12T11:16:47.487Z","etag":null,"topics":["drawing","gtk","gtk-rs","gtk4","gtk4-rs","hacktoberfest","handwriting","infinite-canvas","notes","notes-app","pdf","rust","wacom-tablet"],"latest_commit_sha":null,"homepage":"https://rnote.flxzt.net","language":"Rust","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/flxzt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS"},"funding":{"github":["flxzt"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"flxzt","issuehunt":null,"otechie":null,"lfx_crowdfunding":null}},"created_at":"2021-08-05T13:04:32.000Z","updated_at":"2025-05-12T06:29:09.000Z","dependencies_parsed_at":"2023-12-27T15:48:42.594Z","dependency_job_id":null,"html_url":"https://github.com/flxzt/rnote","commit_stats":null,"previous_names":[],"tags_count":64,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flxzt%2Frnote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flxzt%2Frnote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flxzt%2Frnote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flxzt%2Frnote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flxzt","download_url":"https://codeload.github.com/flxzt/rnote/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253726904,"owners_count":21954095,"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":["drawing","gtk","gtk-rs","gtk4","gtk4-rs","hacktoberfest","handwriting","infinite-canvas","notes","notes-app","pdf","rust","wacom-tablet"],"created_at":"2024-07-31T16:01:55.950Z","updated_at":"2025-05-12T11:17:06.430Z","avatar_url":"https://github.com/flxzt.png","language":"Rust","readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/flxzt/rnote/main/crates/rnote-ui/data/icons/scalable/apps/rnote.svg\" width=\"300\"\u003e\u003c/img\u003e\n\u003c/div\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/flxzt/rnote/actions/workflows/ci.yml\"\u003e\n        \u003cimg alt=\"CI\"src=\"https://github.com/flxzt/rnote/actions/workflows/ci.yml/badge.svg\"\u003e\u003c/img\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://liberapay.com/flxzt/donate\"\u003e\n        \u003cimg alt=\"Donate using Liberapay\" src=\"https://raw.githubusercontent.com/flxzt/rnote/main/misc/assets/liberapay-donate-button.svg\" width=\"60\" height=\"20\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\n# Rnote\n\n\u003e Sketch and take handwritten notes.  \n\nRnote is an open-source vector-based drawing app for sketching, handwritten notes and to annotate documents and pictures.\nIt is targeted at students, teachers and those who own a drawing tablet and provides features like Pdf and picture import and export,\nan infinite canvas and an adaptive UI for big and small screens.\n\nWritten in Rust and GTK4.\n\n**Features**\n\n- Adaptive UI focused on stylus input\n- Pressure-sensitive stylus input with different and configurable stroke styles\n- Create many different shapes with the shape tool\n- Move, rotate, resize and modify existing content with the selection tool\n- Different document expansion layouts ( fixed pages, continuous vertical, infinite in every direction, .. )\n- Customizable background colors, patterns, sizes\n- Customizable page format\n- (Optional) pen sounds\n- Reconfigurable stylus button shortcuts\n- An integrated workspace browser for quick access to related files\n- Drag \u0026 Drop, clipboard support\n- Pdf, Bitmap and Svg image import\n- Documents can be exported to Svg, Pdf and Xopp. Document pages and selections to Svg, Png and Jpeg.\n- Save and load the documents in the native `.rnote` file format\n- Tabs to work on multiple documents at the same time\n- Autosave, printing\n\n**Disclaimer**\n\nThe file format is still unstable. It might change and break compatibility between versions.\n\n## Website\n\nRnote has a project website: [rnote.flxzt.net](https://rnote.flxzt.net/)\n\n## Installation\n\n### Linux\n\nDownload the official flatpak on Flathub [here](https://flathub.org/apps/details/com.github.flxzt.rnote).\n\n\u003cdiv align=\"start\"\u003e\n\u003ca href='https://flathub.org/apps/details/com.github.flxzt.rnote'\u003e\u003cimg width=\"250\" alt='Download on Flathub' src='https://raw.githubusercontent.com/flxzt/rnote/main/misc/assets/flathub-badge.svg'/\u003e\u003c/a\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n### MacOS\n\nThanks to @dehesselle the app is available on MacOS as an app bundle.  \nCheck out the [repository](https://gitlab.com/dehesselle/rnote_macos), the latest release can be downloaded [here](https://gitlab.com/dehesselle/rnote_macos/-/releases/permalink/latest).\n\n\u003cdiv align=\"start\"\u003e\n\u003ca href='https://gitlab.com/dehesselle/rnote_macos/-/releases/permalink/latest'\u003e\u003cimg height=\"150\" alt='Download MacOS app bundle' src='https://raw.githubusercontent.com/flxzt/rnote/main/misc/assets/rnote-macos-app-bundle-badge.png'/\u003e\u003c/a\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n### Windows\n\nDownload the Windows installer from the latest release which can be found [here](https://github.com/flxzt/rnote/releases/latest).\n\n\u003cdiv align=\"start\"\u003e\n\u003ca href='https://github.com/flxzt/rnote/releases/latest'\u003e\u003cimg width=\"250\" alt='Download Windows installer' src='https://raw.githubusercontent.com/flxzt/rnote/main/misc/assets/windows-installer-badge.svg'/\u003e\u003c/a\u003e\n\u003c/div\u003e\u003cbr\u003e\n\nInstall using [Winget](https://github.com/microsoft/winget-pkgs/tree/master/manifests/f/flxzt/rnote):\n\n```\nwinget install flxzt.rnote\n```\n\n### Downgrading\n\nBecause the file format still is unstable, downgrading to a specific version might be necessary.\n\nList all available past versions on flathub:\n\n```bash\nflatpak remote-info --log flathub com.github.flxzt.rnote\n```\n\nPick the commit from the desired version and downgrade with:\n\n```bash\nsudo flatpak update --commit=\u003ccommit-hash\u003e com.github.flxzt.rnote \n```\n\nAfter downgrading, the flatpak version can be pinned or unpinned with:\n\n```\n$ flatpak mask com.github.flxzt.rnote\n$ flatpak mask --remove com.github.flxzt.rnote\n```\n\nTo update to the latest version again, unpin and run `flatpak update`.\n\n## Screenshots\n\n![overview](./crates/rnote-ui/data/screenshots/overview.png)  \n![selection](./crates/rnote-ui/data/screenshots/selection.png)  \n![typewriter](./crates/rnote-ui/data/screenshots/typewriter.png)  \n![focus-mode](./crates/rnote-ui/data/screenshots/focus-mode.png)  \n![workspaces](./crates/rnote-ui/data/screenshots/workspaces.png)  \n![document-settings](./crates/rnote-ui/data/screenshots/document-settings.png)  \n![action-shortcuts](./crates/rnote-ui/data/screenshots/action-shortcuts.png)  \n\n## Pitfalls \u0026 Known Issues\n\n* Drag \u0026 Drop not working -  \n    Make sure Rnote has permissions to the locations you are dragging files from. Can be granted in Flatseal (a Flatpak permissions manager)\n\n* Odd location for current file -  \n    When the directory displayed in the header title is something like `/run/user/1000/../`, rnote does not have permissions to access the directory. Again, granting them in Flatseal fixes this issue.\n\n* Stylus buttons move canvas / are not functional -  \n    Make sure that the `xf86-input-wacom`, drivers on X11 and `libinput` on Wayland and `libwacom` are installed and loaded.\n\n* While hovering with the stylus, other input events are blocked in some regions of the screen -  \n    Supposed to be palm rejection, but might be undesirable. If there is a left- / righthanded system tablet setting, make sure it is set correctly. Rnote can't disable this unfortunately. ( discussed in issue [#329](https://github.com/flxzt/rnote/issues/329) )\n\n* One of the stylus buttons shortcut mapping does not work as intended -  \nOn some devices one stylus button is mapped to a dedicated \"Eraser\" mode (which is the back-side on other styli). The buttons in the shortcuts settings could then be inconsistent ( the secondary / upper button is actually the primary / lower button , or reverse ). To change the tool that is mapped to this \"Eraser\" mode, do the following:  \n    * Hover over the canvas, and press and hold the button that is suspected to be mapped to the \"Eraser\" mode\n    * Switch to the desired pen style while keeping the button pressed\n    * When releasing the pressed button, it should switch back to the previous pen style\n    * The pen style in the \"Eraser\" mode should now be remembered\n\n## Translations\n\n\u003ca href=\"https://hosted.weblate.org/engage/rnote/\"\u003e\n\u003cimg src=\"https://hosted.weblate.org/widgets/rnote/-/repo/multi-auto.svg\" alt=\"Translation status\" /\u003e\n\u003c/a\u003e\u003cbr\u003e\u003cbr\u003e\n\nIf you want to start contribute by translating, take a look into the [translations section](./CONTRIBUTING.md#Translations)\nof the CONTRIBUTING document.\n\n## Fonts\n\nThe following fonts are bundled with the application:\n\n- [Grape Nuts](https://fonts.google.com/specimen/Grape+Nuts): Grape Nuts is a simple handwritten casual font.\n- [OpenDyslexic-Regular](https://github.com/antijingoist/opendyslexic): OpenDyslexic is a typeface designed against some\n    common symptoms of dyslexia.\n- [TT2020Base-Regular](https://github.com/ctrlcctrlv/TT2020): TT2020 is an advanced, open source, hyperrealistic,\n    multilingual typewriter font for a new decade.\n- [Virgil](https://virgil.excalidraw.com/): The font that powers Excalidraw.\n\n## File Format\n\nThe `.rnote` file format is a gzipped json file.\n\nSo far breaking changes in the format happened in versions:\n\n- `v0.2.0`\n- `v0.3.0`\n- `v0.4.0`\n- `v0.5.0`\n\nTo be able to open and export older files that are incompatible with the newest version, look under **Installation** /**Downgrading** to install older versions of Rnote.\n\n## License\n\nRnote is available under GPL-3.0-or-later. See the LICENSE file for more info.\n\n    Copyright (C) 2023  The Rnote Authors\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 \u003chttps://www.gnu.org/licenses/\u003e.\n\n## Credits\n\n- A huge thanks to the contributors, translators and to all that donated. You are the ones that help keep the project going!\n- [Freesound](https://freesound.org/) is the source for the pen sounds. The individual sounds are credited in `sounds/Licenses.md`\n- [Rough.js](https://roughjs.com/) provides the algorithms for implementation of Rnote's rough shapes.\n- [Pizarra](https://pizarra.categulario.xyz/en/) is an innovative drawing app with advanced shaping and featuring an infinite zoom. It is a great inspiration of the architecture of Rnote. Go check it out!\n\n\n## Community\n\nIf you have any questions or want to start a general discussion, open a topic in the [Github Discussions](https://github.com/flxzt/rnote/discussions) section.\n\nThere are also two Matrix chat rooms:\n- for users: [#rnote:matrix.org](https://matrix.to/#/#rnote:matrix.org)\n- for developers: [#rnote-dev:matrix.org](https://matrix.to/#/#rnote-dev:matrix.org)\n\n## Drawings Created With Rnote\n\nIf you have drawn something cool in Rnote and want to share it, submit a PR to add it here. :)  \n\n\u003cdiv align=\"center\" spacing=\"20px\"\u003e\n        \u003cimg alt=\"Pikachu\" src=\"https://raw.githubusercontent.com/flxzt/rnote/main/misc/drawings/pikachu.png\" height=\"400\"\u003e\n        \u003cimg alt=\"Love\" src=\"https://raw.githubusercontent.com/flxzt/rnote/main/misc/drawings/love.png\" height=\"400\"\u003e\n        \u003cimg alt=\"Suits\" src=\"https://raw.githubusercontent.com/flxzt/rnote/main/misc/drawings/suits.png\" height=\"400\"\u003e\n        \u003cimg alt=\"Nature's cat\" src=\"https://raw.githubusercontent.com/flxzt/rnote/main/misc/drawings/natureza_gato.png\" height=\"400\"\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n## Building\n\nBuild instructions for Linux are documented in [BUILDING.md](./BUILDING.md) and for other platforms [here](./misc/building)\n","funding_links":["https://github.com/sponsors/flxzt","https://liberapay.com/flxzt","https://liberapay.com/flxzt/donate"],"categories":["Rust","Applications","Productivity","语言资源库","Editor","rust","Table of Contents","Office"],"sub_categories":["Graphics","Markdown \u0026 Note-taking","rust","Note Taking","Note-taking"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflxzt%2Frnote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflxzt%2Frnote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflxzt%2Frnote/lists"}