Debian / Ubuntu (.deb)

Download the .deb package from the releases page, then install:

sudo apt install ./carrotnotes_0.1.0_amd64.deb

AppImage (portable)

No installation required — make it executable and run:

chmod +x carrotnotes_0.1.0_amd64.AppImage
./carrotnotes_0.1.0_amd64.AppImage

Fedora / RPM-based (.rpm)

An .rpm package is also available on the releases page.

sudo dnf install ./carrotnotes-0.1.0-1.x86_64.rpm

Build from source

Requirements: Node.js 18+, Rust 1.77+, and Tauri prerequisites for Linux.

git clone https://github.com/shakerbr/carrot-notes.git
cd carrot-notes
npm install
npm run build

Built packages are output to src-tauri/target/release/bundle/.

Development

npm run dev

On GNOME + Wayland, dev and production builds use XWayland so always-on-top works without a shell extension.

Configuration

Notes~/.local/share/com.shakerbr.carrotnotes/notes.json
Settings~/.local/share/com.shakerbr.carrotnotes/settings.json
Sync folderUser-defined (contains .md files + carrotnotes_backup.json)

Environment variables

CARROTNOTES_NATIVE_WAYLAND=1Use native Wayland instead of XWayland. Always-on-top may require an optional GNOME shell extension.

Known limitations

  • Best tested on GNOME; other Linux desktops may differ
  • Cloud sync requires your own server — no official Carrot cloud
  • Desktop only — no mobile or web client in v0.1.0
  • Early release — issues and feedback welcome

← Back to home