Tmux QuickURL

A simple tmux plugin that helps you quickly open URLs from a predefined list using fzf.

Preview

Requirements

• tmux
• fzf
• tpm
• xdg-open (usually pre-installed on Linux)

Installation

Using TPM (recommended)

Add this line to your ~/.tmux.conf:

set -g @plugin 'merkksgit/tmux-quickurl'

Press prefix + I to install the plugin.

Add this line to your ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-quickurl/tmux-quickurl.tmux

Update with TPM

Press prefix + U (capital U) to update this plugin along with other TPM plugins.

Usage

1. Create or edit ~/.quickurls file
2. Add your URLs, one per line. For example:

https://www.github.com
https://www.google.com
https://www.youtube.com

3. Press prefix + u to open the URL picker
4. Select a URL using fzf
5. The URL will open in your default browser

URL File Format

• The URL file should be located at ~/.quickurls
• Each URL should be on its own line
• URLs should be complete with protocol (e.g., 'https://', 'http://', 'ftp://')
• Optional: Add descriptions using # comment syntax
• Empty lines will be ignored

URL Descriptions

You can add descriptions to your URLs for easier identification in the picker. Simply add a # followed by your description:

https://www.github.com #GitHub
https://www.google.com #Search Engine
https://192.168.1.100:9000 #Portainer
https://www.youtube.com

URLs with descriptions will be displayed as Description | URL in the picker, making them easier to identify.

Configuration

You can change the default key binding in your .tmux.conf:

set -g @quickurl-key 'U'  # Changes the key binding to prefix + U

Debugging

The plugin logs activity to /tmp/url_opener.log to help troubleshoot issues. This log includes:

• Session start timestamps
• Dependency checks
• URL selections
• URL validation results
• URL opening attempts
• xdg-open outputs and errors

If you experience any issues like tmux freezes or URLs not opening, check this log file for error messages.

Error Handling

The plugin includes robust error handling:

• Dependency checks: Validates that fzf and xdg-open are installed before running
• URL validation: Ensures URLs have valid protocol formats (http://, https://, ftp://, file://)
• Error reporting: Shows clear messages when URLs fail to open
• Multi-URL support: When opening multiple URLs, reports success/failure counts