Metadata-Version: 2.3
Name: installed-browsers
Version: 0.1.5
Summary: Python library to check installed browsers
License: MIT
Author: undeflorate
Author-email: swanslayer@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: pywin32 (>=303,<311) ; sys_platform == "win32"
Requires-Dist: pyxdg (>=0.27,<0.29) ; sys_platform == "linux"
Project-URL: Repository, https://github.com/undeflorate/installed_browsers
Description-Content-Type: text/markdown

<table>
<div align="center">
<img src="https://img.shields.io/github/created-at/undeflorate/installed_browsers?logo=github&label=since">
<img src="https://img.shields.io/pypi/l/installed-browsers?logo=pypi&logoColor=yellow&color=white">
<img src="https://img.shields.io/pypi/dm/installed-browsers?logo=pypi&logoColor=yellow">
<img src="https://img.shields.io/github/watchers/undeflorate/installed_browsers?logo=github&style=flat">
</div>
<div align="center">
<img src="https://img.shields.io/github/commit-activity/t/undeflorate/installed_browsers?logo=github">
<img src="https://img.shields.io/github/last-commit/undeflorate/installed_browsers/master?logo=github">
</div>
<div align="center">
<img src="https://img.shields.io/github/deployments/undeflorate/installed_browsers/production?logo=github&label=deployment">
<img src="https://img.shields.io/pypi/status/installed-browsers?logo=pypi&logoColor=yellow">
<img src="https://img.shields.io/github/actions/workflow/status/undeflorate/installed_browsers/python-app.yml?branch=master&logo=githubactions&logoColor=white&label=test%20automation">
<img src="https://img.shields.io/codecov/c/github/undeflorate/installed_browsers/master?logo=codecov">
</div>
<div align="center">
<img src="https://img.shields.io/github/issues/undeflorate/installed_browsers?logo=github">
<img src="https://img.shields.io/pypi/pyversions/installed-browsers?logo=python&logoColor=green">
<img src="https://img.shields.io/github/v/release/undeflorate/installed_browsers?logo=github">
<img src="https://img.shields.io/pypi/v/installed-browsers?logo=pypi&logoColor=yellow">
</div>
</table>

# installed browsers
A simple python library to help you identify the installed browsers in your host operating system.

## functions you can do with this library
+ identify installed browsers
+ identify default browser
+ get specific browser details
+ get specific browser version

## supported operating systems
+ linux
+ macos
+ windows

## supported browsers
+ google chrome
+ google chrome canary [^1]
+ chromium
+ firefox
+ firefox developer [^1]
+ firefox nightly [^1]
+ safari [^2]
+ opera
+ opera beta
+ opera developer
+ internet explorer [^3]
+ microsoft edge
+ microsoft edge beta
+ microsoft edge canary [^1]
+ microsoft edge developer
+ brave
+ brave beta
+ brave nightly
+ vivaldi [^4]
+ vivaldi snapshot [^4]
+ min
+ arc [^2]
+ kosmik [^2]
+ pale moon [^1]  
[^1]: only for mac and windows
[^2]: only for mac
[^3]: only for windows
[^4]: windows has restrictions

> [!NOTE]
> Firefox beta, developer and nightly are portable versions in linux, these cannot be installed through package managers.  
> Identification of these versions (as kind of local installations) is not supported by this library.

> [!NOTE]
> Vivaldi stable and snapshot cannot be installed simultaneously on windows. Any of them counts as vivaldi after installation, only the application icon and version number differ between these, but only one instance can be used.   
> For identification, it does not matter which one is installed, it is detected as vivaldi.

> [!NOTE]
> Kosmik is partially supported by mac. Identification works but from its specific nature, browser cannot be set as default currently.

> [!NOTE]
> Pale moon is not supported by linux as it behaves as a kind of local installation.

> [!IMPORTANT]
> **Firefox beta is not supported** in any of the operating systems as it is almost identical with the stable version.
> + Beta and stable versions use the same naming convention. For proper working, make sure that either stable or beta version is installed but not both.
> + For mac, you need to add a different application name for beta if you have already installed the stable version previously.  
> + By default, in windows, beta is installed into a different location than stable: `Application Data`.
> 
> Technical naming is the same, so python is not able to make proper difference between these versions. It is quite likely that you get beta details for stable version and vice versa. To avoid this inconsistent behaviour, **do not install firefox stable and beta** altogether.

## how to install?
```bash
pip install installed_browsers
```

## usage
### import
```python
import installed_browsers
```
### identify installed browsers
Returns an iterator of dictionary of browser key and information.
```python
import installed_browsers

print(list(installed_browsers.browsers()))
```
#### output
```
[{'name': 'chrome', 'description': 'Google Chrome', 'version': '123.0.6312.58', 'location': '/usr/bin/google-chrome-stable'},
{'name': 'firefox', 'description': 'Firefox Web Browser', 'version': '124.0', 'location': 'firefox'}]
```
### identify default browser
Returns default browser description.
```python
import installed_browsers

print(installed_browsers.what_is_the_default_browser())
```
#### output
```
Google Chrome
```
### check if browser is installed
Returns `True` if the browser is installed.
```python
import installed_browsers

print(installed_browsers.do_i_have_installed("chrome"))
```
#### output
```
True
```
### get specific browser details
Returns a dictionary containing browser name, description, desktop version and location.
```python
import installed_browsers

print(installed_browsers.give_me_details_of("chrome"))
```
#### output
```
{'name': 'chrome', 'description': 'Google Chrome', 'version': '123.0.6312.58', 'location': '/usr/bin/google-chrome-stable'}
```
### get specific browser version
Returns a dictionary containing browser version.
```python
import installed_browsers

print(installed_browsers.get_version_of("chrome"))
```
#### output
```
{'version': '123.0.6312.58'}
```
## references
Thanks for the inspiration to [Ronie Martinez](https://github.com/roniemartinez/browsers).

