Carrot Notes

Download

Download v0.1.1 .deb (amd64)AppImage (amd64)

Debian / Ubuntu (.deb)

Recommended for Ubuntu and Debian-based distributions. Run apt update before installing so dependencies resolve correctly.

sudo apt update
sudo apt install ./carrotnotes_0.1.1_amd64.deb

Troubleshooting

On some distros (Kubuntu, fresh Debian, elementary OS, etc.), apt install may fail with unmet dependencies: libayatana-appindicator3-1 or libwebkit2gtk-4.1-0. Run sudo apt update first. If it still fails, use the AppImage.

AppImage (portable)

No installation required — make it executable and run:

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

Fedora / RPM-based (.rpm)

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

sudo dnf install ./carrotnotes-0.1.1-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 folder	User-defined (contains `.md` files + `carrotnotes_backup.json`)

Environment variables

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

Cloud sync API

Install Carrot Notes