| Name | pybrowsers-profiles JSON |
| Version |
0.0.13
JSON |
| download |
| home_page | None |
| Summary | Simple script for manage browser's profiles. |
| upload_time | 2024-07-18 17:26:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License
Copyright (c) 2023-present haaag <git.haaag@gmail.com>
Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to the following
conditions:
The above copyright notice and this permission notice shall be included in all copies
or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
dmenu
firefox
librewolf
profiles
rofi
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
[](https://github.com/pypa/hatch)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/astral-sh/ruff)
[](https://github.com/astral-sh/ruff)
[](https://github.com/python/mypy)
[](https://spdx.org/licenses/)
</div>
## 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](https://tools.suckless.org/dmenu/)
- [rofi](https://github.com/davatorium/rofi) _(Optional)_
- [fzf](https://github.com/junegunn/fzf) _(Optional)_
### 📦 Installation
#### Using `pipx` _(recommended)_
```bash
$ pipx install pybrowsers-profiles
```
> [pipx Homepage](https://github.com/pypa/pipx)
#### Using `pip` install
```bash
# 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 deps
$ (.venv ) pip install -r requirements.txt
# Install script in local environment
$ (.venv ) pip install .
```
### 🚀 Usage
```bash
$ 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
-u, --url Open <URL> 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
```bash
# Open menu with browsers found
$ pybrowsers
```
#### Use flag `browser` for browser's profile
```bash
# Open menu with profiles list
$ pybrowsers firefox
```
#### Use flag `-o, --open` for launching profile with url
<div align="left">
<img align="center" src="assets/flag-open-with-browser.png">
</div>
#### Use flag `-m, --menu` to specify the launcher you want to use _(default: `dmenu`)_
<div align="left">
<img align="center" src="assets/flag-rofi-dark.gif">
</div>
#### Use flag `-l, --list` for status
<div align="left">
<img align="center" src="assets/flag-list.png">
</div>
<br>
#### Use flag `-d, --disable` or `-e, --enable`
```bash
# Disable browser (won't appear in `browsers found`)
$ pybrowsers -d firefox
# Enable browser
$ pybrowsers -e firefox
```
#### ~~Use flag `-r, --running`~~
~~<p><em>Supported on: 🦊</em></p>~~
~~This flag will show all running browsers and profiles, as long as it has been
opened with `pybrowsers`.~~
### ➕ Add Browser
You can add a browser creating a `JSON` file in `$XDG_DATA_HOME/pybrowsers/` or
`~/.local/share/pybrowsers`
#### Example
```json
{
"name": "LibreWolf",
"command": "librewolf",
"path": "~/.librewolf/profiles.ini",
"engine": "gecko",
"enabled": true
}
```
### 🌐 Browsers
- 🦊 [Firefox](https://www.mozilla.org/firefox/download/thanks/)
- [LibreWolf](https://librewolf.net/)
- [Chromium](https://www.chromium.org/getting-involved/download-chromium/)
- Brave
- Google Chrome
### 🧰 Dependencies
- [PySelector](https://pypi.org/project/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)_
Raw data
{
"_id": null,
"home_page": null,
"name": "pybrowsers-profiles",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "dmenu, firefox, librewolf, profiles, rofi",
"author": null,
"author_email": "haaag <git.haaag@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/05/bc/10e8759e83803c100b69048c0a7d7c248a31e2246c1aabdf2395aed6d102/pybrowsers_profiles-0.0.13.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n\n[](https://github.com/pypa/hatch)\n[](https://github.com/pre-commit/pre-commit)\n\n[](https://github.com/astral-sh/ruff)\n[](https://github.com/astral-sh/ruff)\n[](https://github.com/python/mypy)\n[](https://spdx.org/licenses/)\n\n</div>\n\n## Profile Launcher\n\n### A Python Script for Effortless Browser Profile Management\n\n### \u2b50 About\n\nThis 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.\n\n### \u26a1\ufe0f Requirements\n\n- [dmenu](https://tools.suckless.org/dmenu/)\n- [rofi](https://github.com/davatorium/rofi) _(Optional)_\n- [fzf](https://github.com/junegunn/fzf) _(Optional)_\n\n### \ud83d\udce6 Installation\n\n#### Using `pipx` _(recommended)_\n\n```bash\n$ pipx install pybrowsers-profiles\n```\n\n> [pipx Homepage](https://github.com/pypa/pipx)\n\n#### Using `pip` install\n\n```bash\n# Clone repository\n$ git clone \"https://github.com/haaag/PyBrowsers\"\n$ cd PyBrowsers-Profiles\n\n# Create virtual environment & source\n$ python -m venv .venv && source .venv/bin/activate\n\n# Install deps\n$ (.venv ) pip install -r requirements.txt\n\n# Install script in local environment\n$ (.venv ) pip install .\n```\n\n### \ud83d\ude80 Usage\n\n```bash\n$ pybrowsers --help\n\nusage: pybrowsers [-l] [-d DISABLE] [-e ENABLE] [-f] [-t]\n [-m MENU] [-v] [-V] [browser] [-o URL]\n\nSimple script for manage browser's profiles\n\noptions:\n browser Browser name\n -e, --enable Enable browser\n -d, --disable Disable browser\n -u, --url Open <URL> in browser\n -l, --list Show browsers list and status\n -t, --table Show browsers list with detail\n -m, --menu Select menu (default: dmenu)\n -f, --found Browsers found\n -V, --version Show version\n -h, --help Show help\n -v, --verbose Verbose mode\n\nlocations:\n $HOME/.local/share/pybrowsers\n```\n\n#### Use `no flags` to launch menu\n\n```bash\n# Open menu with browsers found\n$ pybrowsers\n```\n\n#### Use flag `browser` for browser's profile\n\n```bash\n# Open menu with profiles list\n$ pybrowsers firefox\n```\n\n#### Use flag `-o, --open` for launching profile with url\n\n<div align=\"left\">\n <img align=\"center\" src=\"assets/flag-open-with-browser.png\">\n</div>\n\n#### Use flag `-m, --menu` to specify the launcher you want to use _(default: `dmenu`)_\n\n<div align=\"left\">\n <img align=\"center\" src=\"assets/flag-rofi-dark.gif\">\n</div>\n\n#### Use flag `-l, --list` for status\n\n<div align=\"left\">\n <img align=\"center\" src=\"assets/flag-list.png\">\n</div>\n<br>\n\n#### Use flag `-d, --disable` or `-e, --enable`\n\n```bash\n# Disable browser (won't appear in `browsers found`)\n$ pybrowsers -d firefox\n\n# Enable browser\n$ pybrowsers -e firefox\n```\n\n#### ~~Use flag `-r, --running`~~\n\n~~<p><em>Supported on: \ud83e\udd8a</em></p>~~\n\n~~This flag will show all running browsers and profiles, as long as it has been\nopened with `pybrowsers`.~~\n\n### \u2795 Add Browser\n\nYou can add a browser creating a `JSON` file in `$XDG_DATA_HOME/pybrowsers/` or\n`~/.local/share/pybrowsers`\n\n#### Example\n\n```json\n{\n \"name\": \"LibreWolf\",\n \"command\": \"librewolf\",\n \"path\": \"~/.librewolf/profiles.ini\",\n \"engine\": \"gecko\",\n \"enabled\": true\n}\n```\n\n### \ud83c\udf10 Browsers\n\n- \ud83e\udd8a [Firefox](https://www.mozilla.org/firefox/download/thanks/)\n- [LibreWolf](https://librewolf.net/)\n- [Chromium](https://www.chromium.org/getting-involved/download-chromium/)\n- Brave\n- Google Chrome\n\n### \ud83e\uddf0 Dependencies\n\n- [PySelector](https://pypi.org/project/pyselector/)\n\n### \ud83e\uddf0 TODO\n\n- [ ] Create `interactive menu` for adding browser data\n- [x] Update screenshots\n- [x] Add `flag` for open URLs\n- [x] Please, use `pathlib.Path`\n- [x] BUG: Issue when the profile name contains spaces\n- [x] Add support for `JSON` files _(prioritize)_\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2023-present haaag <git.haaag@gmail.com>\n \n Permission is hereby granted, free of charge, to any person obtaining a copy of this\n software and associated documentation files (the \"Software\"), to deal in the Software\n without restriction, including without limitation the rights to use, copy, modify,\n merge, publish, distribute, sublicense, and/or sell copies of the Software, and to\n permit persons to whom the Software is furnished to do so, subject to the following\n conditions:\n \n The above copyright notice and this permission notice shall be included in all copies\n or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,\n INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR\n PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\n TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE\n USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "Simple script for manage browser's profiles.",
"version": "0.0.13",
"project_urls": {
"Bug Tracker": "https://github.com/haaag/PyBrowsers-Profiles/issues",
"Homepage": "https://github.com/haaag/PyBrowsers-Profiles"
},
"split_keywords": [
"dmenu",
" firefox",
" librewolf",
" profiles",
" rofi"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ae9c0bc1baa60bb2207039835689351e585ffab72b22ba21572c10ff45a658c4",
"md5": "35872ede578a9c328d9697251b2f86ca",
"sha256": "ff2ce9d3f85db1bda5384761f1667c97b7cc746e36a446f5387fd29e857909ca"
},
"downloads": -1,
"filename": "pybrowsers_profiles-0.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "35872ede578a9c328d9697251b2f86ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9980,
"upload_time": "2024-07-18T17:26:18",
"upload_time_iso_8601": "2024-07-18T17:26:18.356646Z",
"url": "https://files.pythonhosted.org/packages/ae/9c/0bc1baa60bb2207039835689351e585ffab72b22ba21572c10ff45a658c4/pybrowsers_profiles-0.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "05bc10e8759e83803c100b69048c0a7d7c248a31e2246c1aabdf2395aed6d102",
"md5": "2bd573e38fabb5cb62a5aa882ccf39e9",
"sha256": "ace1ea673a83285d0ac08bee2f94258c47228b5af7403c29c356c6d7fa5daae0"
},
"downloads": -1,
"filename": "pybrowsers_profiles-0.0.13.tar.gz",
"has_sig": false,
"md5_digest": "2bd573e38fabb5cb62a5aa882ccf39e9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9181,
"upload_time": "2024-07-18T17:26:16",
"upload_time_iso_8601": "2024-07-18T17:26:16.816499Z",
"url": "https://files.pythonhosted.org/packages/05/bc/10e8759e83803c100b69048c0a7d7c248a31e2246c1aabdf2395aed6d102/pybrowsers_profiles-0.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-18 17:26:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "haaag",
"github_project": "PyBrowsers-Profiles",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pybrowsers-profiles"
}
