saber-notes / saber

The cross-platform open-source app built for handwriting
https://saber.adil.hanney.org
GNU General Public License v3.0
1.94k stars 118 forks source link
android cross-platform dart f-droid flatpak flutter handwritten-notes ios linux macos notes notes-app saber windows

Logo Saber

<img src='https://github.com/saber-notes/saber/blob/main/assets_raw/badges/google-play-badge.png' alt='Get it on Google Play' height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/f-droid-badge.png" alt="Get it on F-Droid" height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/app-store-badge.svg" alt="Download on the App Store" height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/windows-badge.png" alt="Download for Windows" height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/flathub-badge.svg" alt="Download on Flathub" height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/appimage-logo.png" alt="Get it as an AppImage" height=50>   <img src="https://github.com/saber-notes/saber/blob/main/assets_raw/badges/snap-badge.svg" alt="Get it from the Snap Store" height=50>

English | čeština | Deutsch | 中文 (简体中文, 中国) | 中文 (繁體, 台灣)

Saber is the notes app built for handwriting.

It's designed to be as simple and intuitive as possible, while still delivering unique features that you'll actually use. Additionally, Saber is available across all your devices, large and small, and syncs between them seamlessly.

Notably, it can invert your notes when you're in dark mode. This allows you to write with white ink on a black background, which is much easier on the eyes in low-light environments like when the teacher turns off the lights in class. Images and PDFs are also inverted, so you can still use a digital printout or a textbook without the fuss.

Saber uses a dual-password system to protect your notes from anyone but you, even if they have complete control over the server. You can safely store your notes on the official Saber server, another server, or even host your own!

The app is completely open-source so that anyone can view the source code and see exactly what it's doing and how it handles your data. Many other note-taking apps are closed-source and proprietary, meaning that their inner workings are a mystery to the public.

As someone who studies maths, highlighting multi-line equations was always a hassle with other apps, where the highlighter would change color when it overlapped with itself. Another problem I had was that in some apps, the highlighter would render on top of the text, fading it out and making it hard to read. Saber's highlighter has no such issues. It utilizes canvas compositing to render the highlighter in a way that is consistent with/better than traditional paper, where it handles overlaps and maintains color consistency.

Saber has everything you need to keep your notes organized. Create folders inside folders inside folders to your heart's content with no limit on the number of nested folders. And even though a note may be buried deep within a nested folder, you can still access it easily with your most recent notes always available on the home screen.

Discover a whole new way to capture and organize your thoughts with Saber. Whether you're a student, professional, or creative mind, Saber is your trusted companion for digital handwriting. Download now and let your ideas flow freely!

GitHub release (latest by date) Flathub F-Droid GitHub all releases Flathub GitHub Sponsors GitHub codecov

Tap to show/hide screenshots

Features

Please see #1 Saber progress.

Install

Tap to show/hide install instructions #### Android Options: 1. Download from the [Play Store][google_play] 2. Download from [F-Droid][f-droid] - Note that the F-Droid build is not optimised for Onyx Boox devices as this would require [proprietary dependencies](https://github.com/saber-notes/saber/issues/219) from Onyx. 3. Download and install `Saber_{version}.apk` from the latest [Release][releases]. #### Linux Option 1 (recommended): Install the flatpak from [Flathub][flathub]: `flatpak --user install com.adilhanney.saber`. Option 2: Download `Saber-{version}-x86_64.AppImage` from the latest [Release][releases], make it executable with `chmod +x Saber-*-x86_64.AppImage`, then run it. Option 3: There's an unofficial [snap][snap] available thanks to @soumyaDghosh. `sudo snap install saber` #### Windows Download and install `SaberInstaller_{version}.exe` from the latest [Release][releases]. If you get missing dll errors, make sure you have [Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) installed. #### iOS and macOS Download Saber on the [App Store][app_store].

Build from source

Tap to show/hide build instructions ### 1. Install flutter https://docs.flutter.dev/get-started/install ### 2. Clone this project ```bash git clone https://github.com/saber-notes/saber.git ``` ### 3. Get dependencies ```bash flutter pub get ``` ### 4. Install additional dependencies Setup for the [super_clipboard](https://pub.dev/packages/super_clipboard) package can be summarised as: - Install [Rust](https://www.rust-lang.org/tools/install) - Install NDK 26.1.10909125 if you're building for Android ### 5. Build for... #### Linux `sudo apt install libsecret-1-dev libjsoncpp-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev` `flutter build linux` This is good enough for using on your own computer, but if you want to redistribute your build, you need to use a predictable environment: fork this repo and use the GitHub Action [Build for Linux](https://github.com/saber-notes/saber/actions/workflows/linux.yml) instead. #### Android `flutter build apk` You may need to generate a signing certificate and create the `android/key.properties` file. More information on https://docs.flutter.dev/deployment/android#create-an-upload-keystore Note: FOSS/[F-Droid][f-droid-manifest] builds are done slightly differently: ```bash ./patches/remove_proprietary_dependencies.sh flutter build apk --dart-define=OFFLINE_FONTS_ONLY="true" ``` #### Windows `flutter build windows` The Windows installer is created with [Inno Setup](https://jrsoftware.org/isinfo.php). To create an installer of your own, run the above build command, then edit and run [installers/desktop_inno_script.iss](https://github.com/saber-notes/saber/blob/main/installers/desktop_inno_script.iss) with Inno Setup Compiler. #### iOS and macOS If you have a macOS computer, you can [build for iOS](https://docs.flutter.dev/deployment/ios#create-an-app-bundle) with `flutter build ipa` or [build for macOS](https://docs.flutter.dev/deployment/macos#create-a-build-archive-with-xcode) with `flutter build macos`. If you don't, fork this repo and use the GitHub Action [Build for macOS and iOS](https://github.com/saber-notes/saber/actions/workflows/apple.yml). Alternatively, follow this YouTube tutorial [How to compile a flutter application to iPhone with no mac (free | no jailbreak)](https://www.youtube.com/watch?v=m3_6z2wfHiY) to manually build with [Codemagic](https://codemagic.io/start/).

Links

Translating

All translations are crowd-sourced. Saber has so far been translated into:

I'm experimenting with using Weblate to crowd-source translations. More information coming soon.

Extending existing languages

Check _missing_translations.yaml to see if any translations are missing.

  1. Use this link to edit _missing_translations.yaml.
  2. Update your _missing_translations.yaml file with your translations, e.g. updating German (de)
    de:
      editor:
        newerFileFormat:
          title: Diese Notiz wurde mit einer neueren Version von Saber bearbeitet
          subtitle: Wenn du diese Notiz bearbeitest, können Daten verloren gehen. Möchtest du die Notiz trotzdem öffnen?
          openAnyway: Trotzdem öffnen
          cancel: Abbruch
    # ignore the other languages...
  3. Open a pull request! I'll do the rest

Adding a new language

  1. Look for your locale code here, e.g. hi for Hindi, fr for French, bn for Bengali, ar for Arabic, etc.
  2. Use this link to create a new file in lib/i18n/community/ called strings_XX.i18n.yaml where XX is your locale code.
  3. Copy the contents of an existing file like lib/i18n/strings.i18n.yaml and replace the translations with your own. If you don't know the translation for a string, just delete the line.
  4. Open a pull request!

Also see slang's Getting Started for more information.

Translating app store descriptions

We have 2 formats for app store descriptions:

  1. F-Droid/Play Store:

    i. Open metadata/en-US/ and copy the full_description.txt and short_description.txt files into the metadata/XX/ folder where XX is your locale code. Then translate the contents of the files.

    ii. Changelogs are automatically translated from the English version. If you spot a mistake, please edit the translated changelog in metadata/XX/changelogs/<version-code>.txt where XX is your locale code.

  2. Linux .desktop file:

    i. Open flatpak/com.adilhanney.saber.desktop and add a line for the Comment key with the following format where XX is your locale code:

    Comment[XX]=Your translation

    If you also need to translate the Name key, do the same thing.

  3. Flathub (optional):

    i. Since this is slightly more technical, you can skip the Flathub part if you want to and I'll copy the translations from the above section.

    ii. In flatpak/com.adilhanney.saber.metainfo.xml before the </description> closing tag, add a line for your translation with the following format where XX is your locale code:

    <p xml:lang="XX">Your translation</p>

    iii. In the same file, you can translate the changelogs by doing the same thing in the <release> tags before their </description> closing tag.

Supporting Saber

If you like Saber, please consider supporting it by:

Development notes

Show/hide development notes - When updating the **app version**: - Run `./scripts/apply_version.sh ` (Run `./scripts/apply_version.sh --help` for more info) - Update the changelogs in `metadata/en-US/changelogs/` and `flatpak/com.adilhanney.saber.metainfo.xml`, and run `dart scripts/translate_changelogs.dart` as directed by the script. - When updating the **icons**, run the following commands: - General: `dart run icons_launcher:create` - Flatpak icons: `cd assets/icon && ./resize-icon.sh` - When updating the **translations**... - Run the following commands: - `dart run slang apply --locale=XX` if you need to apply _missing_translations.yaml - `dart run slang` - `dart run slang analyze --full` - If you're adding a new language, update: - `CFBundleLocalizations` in `ios/Runner/Info.plist` - `CFBundleLocalizations` in `macos/Runner/Info.plist` - `android/app/src/main/res/xml/locales_config.xml` - `lib/data/locales.dart` - `README.md` above in the "Translating" section. - and run `dart scripts/translate_changelogs.dart` to translate the changelog.