pybrowsers-profiles

Profile Launcher

A Python Script for Effortless Browser Profile Management

⭐ About

This Python script simplifies launching browser profiles by automatically retrieving profile information from each browser's config directory. It presents these profiles as launch options, saving time and enhancing workflow, especially for users who frequently switch between multiple profiles.

⚡️ Requirements

• dmenu
• rofi (Optional)
• fzf (Optional)

📦 Installation

Using pipx (recommended)

$ pipx install pybrowsers-profiles

> pipx Homepage

Using pip install

# Clone repository
$ git clone "https://github.com/haaag/PyBrowsers"
$ cd PyBrowsers-Profiles

# Create virtual environment & source
$ python -m venv .venv && source .venv/bin/activate

# Install
$ pip install .

🚀 Usage

$ pybrowsers --help

usage: pybrowsers [-l] [-d DISABLE] [-e ENABLE] [-f] [-t]
                  [-m MENU] [-v] [-V] [browser] [-o URL]

Simple script for manage browser's profiles

options:
    browser             Browser name
    -e, --enable        Enable browser
    -d, --disable       Disable browser
    -r, --running       Browser running and profile
    -u, --url           Open  in browser
    -l, --list          Show browsers list and status
    -t, --table         Show browsers list with detail
    -m, --menu          Select menu (default: dmenu)
    -f, --found         Browsers found
    -V, --version       Show version
    -h, --help          Show help
    -v, --verbose       Verbose mode

locations:
    $HOME/.local/share/pybrowsers

Use no flags to launch menu

# Open menu with browsers found
$ pybrowsers

Use flag browser for browser's profile

# Open menu with profiles list
$ pybrowsers firefox

Use flag -o, --open for launching profile with url

Use flag -m, --menu to specify the launcher you want to use (default: dmenu)

Use flag -l, --list for status

Use flag -d, --disable or -e, --enable

# Disable browser (won't appear in `browsers found`)
$ pybrowsers -d firefox

# Enable browser
$ pybrowsers -e firefox

Use flag -r, --running

This flag will show all running browsers and profiles, as long as it has been opened with pybrowsers

$ pybrowsers -r --url 

➕ Add Browser

You can add a browser creating a JSON file in $XDG_DATA_HOME/pybrowsers/ or ~/.local/share/pybrowsers

Example

{
  "name": "LibreWolf",
  "command": "librewolf",
  "path": "~/.librewolf/profiles.ini",
  "engine": "gecko",
  "enabled": true
}

🌐 Browsers

• Firefox
• LibreWolf
• Chromium
• Brave
• Google Chrome

🧰 Dependencies

• PySelector

🧰 TODO

• [ ] Create interactive menu for adding browser data
• [x] Update screenshots
• [x] Add flag for open URLs
• [x] Please, use pathlib.Path
• [x] BUG: Issue when the profile name contains spaces
• [x] Add support for JSON files (prioritize)