Noctalia Launcher RBW Plugin

A Bitwarden/Vaultwarden password manager plugin for the Noctalia launcher that provides secure password management through the RBW (Rust Bitwarden) CLI client.

Features

• 🔐 Secure vault management - Unlock/lock your Bitwarden vault
• 🔍 Quick password search - Find entries by name, username, or folder
• 📋 Password to clipboard - Copy passwords to clipboard with one click
• 🔑 TOTP/2FA codes - Copy TOTP codes via >rbw totp command
• 🚀 Fast launcher integration - Access via >rbw command prefix
• 🎨 Noctalia-native UI - Consistent with Noctalia's design language

Requirements

System Dependencies

• RBW - Rust Bitwarden CLI client
• wl-clipboard - Wayland clipboard utility (wl-copy)
• Noctalia Shell 4.6.6 or higher

Installation of Dependencies

Arch Linux:

yay -S rbw wl-clipboard

Ubuntu/Debian:

sudo apt install wl-clipboard
cargo install rbw

NixOS:

nix-shell -p rbw wl-clipboard

Installation

Method 1: Through Noctalia Plugin Manager (Recommended)

1. Open Noctalia Settings
2. Go to Plugins section
3. Search for "RBW Bitwarden Plugin"
4. Click Install

Method 2: Manual Installation

1. Clone this repository:

   git clone https://github.com/JanValiska/noctalia-launcher-rbw-plugin.git
   

2. Copy to your Noctalia plugins directory:

   cp -r noctalia-launcher-rbw-plugin ~/.local/share/noctalia/plugins/
   

3. Restart Noctalia or reload plugins

Setup

1. Configure RBW

Before using the plugin, you need to set up RBW with your Bitwarden account:

# For Bitwarden.com
rbw config set email your-email@example.com

# For Vaultwarden self-hosted
rbw config set base_url https://your-vaultwarden-server.com
rbw config set email your-email@example.com

# Register and login
rbw register
rbw login

2. Initial Unlock

rbw unlock

Usage

Basic Commands

1. Open the plugin: Type >rbw in the Noctalia launcher
2. Search passwords: Type >rbw github to find entries matching "github" (searches name, username, and folder)
3. TOTP/2FA codes: Type >rbw totp github to get TOTP codes
4. Unlock vault: If locked, select "Unlock RBW Vault" — the launcher closes so pinentry can appear, then reopens automatically
5. Lock vault: Select "Lock RBW Vault" from any >rbw result list

When the query is empty (>rbw with no search term), the 5 most recent entries are shown as a quick-access list.

IPC Commands

# Unlock the vault
qs -c plugin:noctalia-launcher-rbw-plugin.unlock

# Lock the vault
qs -c plugin:noctalia-launcher-rbw-plugin.lock

# Refresh entries
qs -c plugin:noctalia-launcher-rbw-plugin.refresh

# Open launcher with >rbw prefix
qs -c plugin:noctalia-launcher-rbw-plugin.open

Workflow Example

1. Press your Noctalia launcher hotkey
2. Type >rbw github
3. See filtered entries for GitHub (matched by name, username, or folder)
4. Click the desired entry
5. Password is copied to clipboard — paste with Ctrl+V

Security Notes

• 🔒 Vault auto-locks: RBW follows your configured timeout settings
• 🚫 No password storage: Passwords are retrieved on-demand from RBW
• 🔐 Encrypted communication: All data comes from RBW's encrypted vault
• ⚡ Session-based: Plugin state does not persist passwords between sessions
• ⚠️ Wayland only: Clipboard copying uses wl-copy and requires a Wayland session

Troubleshooting

Plugin Not Appearing

• Verify Noctalia version is 4.6.6+
• Check that manifest.json is valid
• Restart Noctalia after manual installation

"RBW command not found"

• Ensure RBW is installed and in your PATH
• Run rbw --version to verify installation

"wl-copy command not found"

• Install wl-clipboard for your distribution
• Note: only Wayland (wl-copy) is supported; X11 clipboard tools are not used

Unlock Fails

• Run rbw login to ensure you're logged in
• Check RBW configuration with rbw config show
• Verify Bitwarden server connectivity

No Entries Showing

• Run rbw list --raw manually to verify RBW is working
• Check that vault is unlocked with rbw unlocked
• Try refreshing: qs -c plugin:noctalia-launcher-rbw-plugin.refresh

Development

Plugin Structure

noctalia-launcher-rbw-plugin/
├── manifest.json         # Plugin metadata
├── Main.qml             # Background logic, process management, IPC handler
├── LauncherProvider.qml # Launcher search integration and UI
├── preview.png          # Plugin preview (960x540)
├── icon.png             # Plugin icon
└── README.md            # This file

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with your Noctalia installation
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Credits

• RBW: doy/rbw - Unofficial Bitwarden CLI
• wl-clipboard: bugaevc/wl-clipboard - Wayland clipboard utilities
• Noctalia: noctalia.dev - Beautiful Qt-based shell

---

Original Author: Jan Valiska janko@valiska.sk — JanValiska/noctalia-launcher-rbw-plugin
Fork by: Tinhead — mostly vibe coded 🤙