qbpm(1)

NAME

qbpm - qutebrowser profile manager

SYNOPSIS

qbpm [--profile-dir=|-P ] [--config-file|-c ] []

DESCRIPTION

qbpm is a tool for creating, managing, and running qutebrowser profiles. Profile support isn't built in to qutebrowser, at least not directly, but it does have a --basedir flag which allows qutebrowser to use any directory as the location of its config and data and effectively act as a profile. qbpm creates profiles that source your main qutebrowser config.py, but have their own separate autoconfig.yml, bookmarks, cookies, history, and other data. Profiles can be run by starting qutebrowser with the appropriate --basedir, or more conveniently using the qbpm launch and qbpm choose commands.

OPTIONS

-h, --help Show help message and quit.

--version Show version information and quit.

-P, --profile-dir Use path as the profile directory instead of the default location. Takes precedence over the QBPM_PROFILE_DIR environment variable.

-c, --config-file Read configuration for qbpm from path. Defaults to ~/.config/qbpm/config.toml.

COMMANDS

new [options] [] Create a new qutebrowser profile named profile. If url is present it will be used as the profile's home page.

Options:

*-l, --launch*
	Launch the profile after it is created.

*-f, --foreground*
	If --launch is set, run qutebrowser in the foreground.

*-C, --qutebrowser-config-dir* <path>
	Source config files from the provided directory instead of the global
	qutebrowser config location.

*--desktop-file/--no-desktop-file*
	Whether to generate an XDG desktop entry for the profile. Only relevant
	on linux systems. See https://wiki.archlinux.org/title/Desktop_entries
	for information on desktop entries.

*--overwrite*
	By default qbpm will refuse to create a profile if one with the same name
	already exists. --overwrite disables this check and replaces the existing
	profile's configuration files. Profile data is left untouched.

launch [options] [arguments...] Start qutebrowser with --basedir set to the location of profile. All arguments following profile will be passed on to qutebrowser.

Options:

*-f, --foreground*
	Run qutebrowser in the foreground instead of forking off a new process.

*-c, --create*
	Create the profile if it does not exist.

Examples:

	```
	\# launch my profile called work and open internal.mycompany.com
	qbpm launch work internal.mycompany.com

	\# launch a new profile called qb-dev, passing the debugging flags to qutebrowser
	qbpm launch -n qb-dev --debug --json-logging
	```

choose [options] [arguments...] Open a menu to choose a qutebrowser profile to launch. On linux this defaults to dmenu or another compatible menu program such as rofi, and on macOS this will be an applescript dialog. All arguments are passed to qutebrowser.

*-m, --menu* <menu>
	Use _menu_ instead of the default menu program. This may be the name of a
	program on $PATH or a path to a program, in which case it will be run in
	dmenu mode if qbpm knows about the program, or a full command line. On
	MacOS the special value "applescript" is accepted. Run `qbpm choose --help`
	for a list of known menu programs for your environment.

Examples:

	```
	qbpm choose --menu fzf

	qbpm choose --menu "./build/my-cool-menu --dmenu-mode --prompt qutebrowser"

	\# qbpm knows about fuzzel so it can automatically invoke it as "~/.local/bin/fuzzel --dmenu"
	qbpm choose --menu ~/.local/bin/fuzzel

	\# if more than one word is provided it will be invoked as is, so `--dmenu` must be included
	qbpm choose --menu 'fuzzel --dmenu --width 100'
	```

from-session [options] [] Create a new qutebrowser profile from session, which may either be the name of a session in the default qutebrowser data directory, or a path to a session file. By default the new profile will be named after session, but a custom profile name can be set via the name argument. Supports the same options as new.

desktop Generate an XDG desktop entry for profile.

edit Open profile's config.py in your default editor.

list List qutebrowser profiles.

AUTHOR

Peter Rice

CONTRIBUTE

https://github.com/pvsr/qbpm

https://codeberg.org/pvsr/qbpm

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!