Vasto for Linux

A GNOME/Adwaita Mastodon client built with Ruby and GTK4/Libadwaita.
Companion to the Vasto iOS app with full ReadSync support.

Features

• 🐘 Home timeline — avatars, media thumbnails, boosts, CW support
• ✏️ Compose toots — with image upload (up to 4), visibility picker, character counter
• 💬 Replies — inline reply from any toot
• ⭐ Fav & boost — with optimistic UI updates
• 🔄 ReadSync — saves and restores your last-read position across all your clients
• 🎨 Adwaita — follows GNOME HIG, dark mode via system preference

Requirements

System packages (install via apt/dnf/pacman):

# Debian / Ubuntu
sudo apt install ruby-dev libgtk-4-dev libadwaita-1-dev \
                 libgirepository1.0-dev gir1.2-gtk-4.0 gir1.2-adw-1

# Fedora
sudo dnf install ruby-devel gtk4-devel libadwaita-devel gobject-introspection-devel

# Arch
sudo pacman -S ruby gtk4 libadwaita gobject-introspection

Ruby gems are managed by Bundler and installed automatically.

Running

./run.sh

Or manually:

bundle install
bundle exec ruby bin/vasto

Login

1. Enter your Mastodon instance URL (e.g. fosstodon.org)
2. Click Connect — your browser opens the authorisation page
3. Authorise Vasto and copy the code shown
4. Paste the code back in Vasto and click Authorise

ReadSync

1. Create an account at https://readsync.wstech.dev and generate an API key
2. Open Preferences → ReadSync, enable it and paste your API key
3. Vasto will now restore your reading position on startup and save it as you scroll

Keyboard shortcuts

Key	Action
F5	Refresh
Ctrl+,	Preferences