🌊 Swell

because no swell, no surf.

A panel-based UI to browse your tabs, history and bookmarks in waves.

Swell turns into a UI panel, a browser-control CLI called mozeidon 🚀

🏄 What you can do

From anywhere on your device, control your web-browser :

• list your tabs, drag and drop to reorder them, and close one, or switch to one, or pin/unpin, or group one, etc
  
  
• list your bookmarks, open one, edit one
  
  
• list your history items, open one, edit one
  
  
• list your recently-closed tabs, open one
  
  
• fire a web-search on your favorite engine like in the URL bar

Note in many scenarios, Swell UI won't be displayed, acting in the background just like a browser-shortcut :

• define your global shortcut to switch to the previous visited tab.
  
  
• define your global shortcut to close the current tab.

🌊 Defining your own shorcuts is a bless ! 🌊

📦 Installation

Latest release ( MacOS and Linux ) : v1.0.0

What you need

• A recent web-browser

• Install this firefox-extension or chrome extension ( version 3.0 coming soon )

  ✅ Note Swell should work with other browsers like Zen, Arc, Brave or Edge.
  ⚠️ You cannot use Swell on multiple browsers at the same time.
  Make sure the extension is active in only one browser.

• Linux users only : install wmctrl or you won't be able to switch to tabs.

• the latest Swell release based on your distribution ( Linux or MacOS )

Troubleshooting

macOS

Some macOS security settings may prevent Swell from opening. 😌 If this happens, run:

xattr -r -d com.apple.quarantine /Applications/swell.app/

Linux

⚠️ Swell may not work well with Gnome desktop ( because Wayland, because focus-stealing prevention )

✅ Swell works well on X11 with e.g Xfce desktop.

⚙️ Swell settings

Swell settings can be modified directly inside the Swell UI.

You might be interested in the underlying settings file :

File location

MacOS

~/Library/Application Support/com.egovelox.swell/settings.json

Linux

~/.local/share/com.egovelkox.swell/settings.json

Defaults ( no defined shortcuts )

{
  "custom_browser_manifests": [],
  "app_settings": {
    "date_locale": "en-EN",
    "global_shortcut_close_current_tab": "",
    "global_shortcut_show_panel_bookmarks": "",
    "global_shortcut_show_panel_history": "",
    "global_shortcut_show_panel_recently_closed": "",
    "global_shortcut_show_panel_settings": "",
    "global_shortcut_show_panel_tabs": "",
    "global_shortcut_switch_last_visited_tab": "",
    "shortcut_close_item": "",
    "shortcut_copy_selected_item_url": "",
    "shortcut_edit_bookmark": "",
    "shortcut_hide_panel": "",
    "shortcut_list_down": "",
    "shortcut_list_up": "",
    "show_favicons": true,
    "theme": "system",
    "web_browser": "firefox",
    "web_search_engine_urls": [
      "https://www.google.com/search?q=",
      "https://addons.mozilla.org/en-US/firefox/search/?q="
    ]
  }
}

Custom example :

{
  "custom_browser_manifests": [],
  "app_settings": {
    "date_locale": "en-EN",
    "global_shortcut_close_current_tab": "Control+p",
    "global_shortcut_show_panel_bookmarks": "Control+w",
    "global_shortcut_show_panel_history": "Control+3",
    "global_shortcut_show_panel_recently_closed": "",
    "global_shortcut_show_panel_settings": "Control+2",
    "global_shortcut_show_panel_tabs": "Control+e",
    "global_shortcut_switch_last_visited_tab": "Control+Enter",
    "shortcut_close_item": "Control+l",
    "shortcut_copy_selected_item_url": "",
    "shortcut_edit_bookmark": "",
    "shortcut_hide_panel": "Control+c",
    "shortcut_list_down": "Control+j",
    "shortcut_list_up": "Control+k",
    "show_favicons": true,
    "theme": "light",
    "web_browser": "Google Chrome",
    "web_search_engine_urls": [
      "https://www.google.com/search?q=",
      "https://addons.mozilla.org/en-US/firefox/search/?q="
    ]
  }
}

🤓 Note for mozeidon CLI users

Once you've installed Swell, you should be able use the mozeidon-cli binary, if you wish !

macOS

/Applications/swell.app/Contents/MacOS/mozeidon-cli

Linux

/usr/bin/mozeidon-cli