Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
73 commits
Select commit Hold shift + click to select a range
f797d13
add: zen browser
fahim-ahmed05 Nov 23, 2024
7dd6673
add: zen browser
fahim-ahmed05 Nov 23, 2024
f1cd75f
version bump to 0.8.0
fahim-ahmed05 Nov 24, 2024
fc4a76f
add pyperclip for copy
fahim-ahmed05 Nov 24, 2024
5ef15d2
add link copy support
fahim-ahmed05 Nov 24, 2024
0ffa819
Floorp added
fahim-ahmed05 Feb 6, 2025
8c8b440
Floorp added
fahim-ahmed05 Feb 6, 2025
868f437
version bump to 0.8.1
fahim-ahmed05 Feb 6, 2025
958c922
checkout, setup-python, cache, upload-artifact version bump to v5
fahim-ahmed05 Feb 6, 2025
786cf3e
checkout, setup-python, cache version bump to v5
fahim-ahmed05 Feb 6, 2025
500800c
checkout, setup-python, cache version bump to v5
fahim-ahmed05 Feb 6, 2025
b02ac18
downgrade actions/checkout, actions/cache, and actions/setup-python t…
fahim-ahmed05 Feb 6, 2025
f7b8abd
downgrade actions/checkout and actions/cache to v4
fahim-ahmed05 Feb 6, 2025
3c6a2b7
downgrade actions/checkout, actions/cache, and actions/upload-artifac…
fahim-ahmed05 Feb 6, 2025
cbff184
Merge branch 'fix_pr-packager'
fahim-ahmed05 Mar 25, 2025
3bc1d9f
Add Brave Nightly to supported browsers in SettingsTemplate.yaml
fahim-ahmed05 Mar 25, 2025
c40b4cf
Add support for Brave Nightly browser in history tracking
fahim-ahmed05 Mar 25, 2025
66d0c2c
Fix variable naming for Floorp directory in browsers.py
fahim-ahmed05 Mar 29, 2025
eec74f2
Add support for Thorium browser in history tracking
fahim-ahmed05 Mar 29, 2025
7c3ac23
Add Custom (Chromium) browser support and custom profile folder optio…
fahim-ahmed05 Mar 29, 2025
1de9f15
Add custom profile path support in BrowserHistory initialization
fahim-ahmed05 Mar 29, 2025
cb69642
Add support for custom Chromium-based browser in history tracking
fahim-ahmed05 Mar 29, 2025
23fd777
Bump version to 0.8.3 in plugin.json
fahim-ahmed05 Mar 29, 2025
4807e43
Bump version to 0.8.5 in plugin.json
fahim-ahmed05 Mar 29, 2025
9a207ae
Add Custom (Firefox) browser support in SettingsTemplate.yaml
fahim-ahmed05 Mar 29, 2025
b1c7982
Add support for custom Firefox browser in history tracking
fahim-ahmed05 Mar 29, 2025
72e4c46
Update browser initialization to support custom profile paths
fahim-ahmed05 Mar 29, 2025
3751fe1
Bump version to 0.8.6 in plugin.json
fahim-ahmed05 Mar 29, 2025
2df657c
Refactor timestamp method to consolidate browser timestamp handling &…
fahim-ahmed05 Apr 10, 2025
d5d2589
Bump version to 0.8.7 in plugin.json
fahim-ahmed05 Apr 10, 2025
ef765b9
Refactor browser history handling to consolidate paths and improve dy…
fahim-ahmed05 Apr 24, 2025
fed2d64
Add Firefox Nightly option to default browser selection
fahim-ahmed05 Apr 24, 2025
d5c7997
Add support for Firefox Nightly profiles in browser history handling
fahim-ahmed05 Apr 24, 2025
83337a2
Enhance dynamic profile support by allowing multiple glob patterns fo…
fahim-ahmed05 Apr 24, 2025
3ce244d
Refactor remove_duplicates function to improve efficiency and clarity
fahim-ahmed05 Apr 24, 2025
f986738
Bump version to 0.8.9 in plugin.json
fahim-ahmed05 Apr 24, 2025
a7481f5
Refactor Browser class initialization to streamline profile handling …
fahim-ahmed05 Apr 24, 2025
efe3a49
Bump version to 0.9.0 in plugin.json
fahim-ahmed05 Apr 24, 2025
2fa8925
Update SettingsTemplate.yaml to add new browser options and profile s…
fahim-ahmed05 Jun 18, 2025
e03ec78
Refactor Browser class to enhance profile selection and streamline in…
fahim-ahmed05 Jun 18, 2025
ed3ed30
Refactor BrowserHistory class to enhance browser initialization, supp…
fahim-ahmed05 Jun 18, 2025
af378c5
Bump version to 1.0.0 in plugin.json
fahim-ahmed05 Jun 18, 2025
651873f
Update SettingsTemplate.yaml for improved browser profile options and…
fahim-ahmed05 Jun 18, 2025
eabb80c
Remove Waterfox profile path from FIREFOX_BASES and add comments to t…
fahim-ahmed05 Jun 18, 2025
8e8cb0d
Fix history limit default value and improve history deduplication and…
fahim-ahmed05 Jun 18, 2025
ad6a1de
Update SettingsTemplate.yaml for improved browser selection and profi…
fahim-ahmed05 Jun 18, 2025
b1680a8
Fix default history limit value from 1000 to 10000 for improved histo…
fahim-ahmed05 Jun 18, 2025
2184920
Update version number to 1.5.2 in plugin.json
fahim-ahmed05 Jun 18, 2025
a14e2c5
Add README.md for Browser History Plugin with installation and config…
fahim-ahmed05 Jun 18, 2025
dcb3c3e
Update installation instructions in README.md for clarity
fahim-ahmed05 Jun 19, 2025
bc2d3f9
Refactor browser profile paths for consistency and clarity
fahim-ahmed05 Jun 26, 2025
39e2cb2
Update version number to 1.5.3 in plugin.json & fixed waterfox issue
fahim-ahmed05 Jun 26, 2025
e551bc8
Add Helium browser option and update version to 1.5.4
fahim-ahmed05 Sep 18, 2025
9e0702a
Clarify instructions for setting default browser or profile and custo…
fahim-ahmed05 Sep 19, 2025
861ccb4
Remove redundant descriptions in SettingsTemplate.yaml for clarity
fahim-ahmed05 Sep 19, 2025
3022e92
Enhance Browser class with robust error handling and support for cust…
fahim-ahmed05 Sep 19, 2025
a689513
Refactor BrowserHistory class to improve error handling and streamlin…
fahim-ahmed05 Sep 19, 2025
0fb46c4
Update version in plugin.json to 1.5.8
fahim-ahmed05 Sep 19, 2025
9a92369
Fix typo in Helium profile path in CHROMIUM_PROFILE_BASES
fahim-ahmed05 Sep 19, 2025
36ae413
Update README.md to use environment variables for profile paths
fahim-ahmed05 Sep 19, 2025
453e140
Implement domain blocking feature in BrowserHistory class
fahim-ahmed05 Sep 22, 2025
d8fd38c
Update SettingsTemplate.yaml for improved labels and add blocked doma…
fahim-ahmed05 Sep 22, 2025
a9ff9cd
Update README.md to include domain blocking feature and blocked domai…
fahim-ahmed05 Sep 22, 2025
38a3d51
Bump version to 1.5.9 in plugin.json
fahim-ahmed05 Sep 22, 2025
21dcd9b
Add default values for custom profile path and blocked domains in Set…
fahim-ahmed05 Sep 22, 2025
70f68ef
Fix blocked domains initialization to handle empty values correctly
fahim-ahmed05 Sep 22, 2025
03f5da7
Update default values for profile settings in SettingsTemplate.yaml
fahim-ahmed05 Sep 22, 2025
7a83d48
Bump version to 1.6.0 in plugin.json
fahim-ahmed05 Sep 22, 2025
05b5f67
Update README.md to clarify settings configuration and adjust default…
fahim-ahmed05 Sep 22, 2025
ccf4769
Fix description formatting for blocked domains in SettingsTemplate.yaml
fahim-ahmed05 Sep 22, 2025
bc55500
Bump version to 1.6.1 in plugin.json
fahim-ahmed05 Sep 22, 2025
6915932
Update labels in README.md and SettingsTemplate.yaml for clarity
fahim-ahmed05 Sep 22, 2025
9cea0ed
Bump version to 1.6.2 in plugin.json
fahim-ahmed05 Sep 22, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/workflows/pr-packager.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ jobs:
runs-on: windows-latest
steps:
- name: Checkout
uses: actions/checkout@v2
uses: actions/checkout@v4
- name: Set up Python ${{ env.PYTHON_VER }}
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHON_VER }}
- uses: actions/cache@v2
- uses: actions/cache@v4
with:
path: ~\AppData\Local\pip\Cache
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
Expand All @@ -27,7 +27,7 @@ jobs:
pip install wheel
pip install -r ./requirements.txt -t ./lib
- name: Upload
uses: actions/upload-artifact@v2
uses: actions/upload-artifact@v4
with:
name: artifact
path: |
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,14 +18,14 @@ jobs:
runs-on: windows-latest
steps:
- name: Checkout
uses: actions/checkout@v2
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Set up Python ${{ env.PYTHON_VER }}
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHON_VER }}
- uses: actions/cache@v2
- uses: actions/cache@v4
if: startsWith(runner.os, 'Windows')
with:
path: ~\AppData\Local\pip\Cache
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/test-plugin.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ jobs:
python_ver: ['3.8']
steps:
- name: Checkout Plugin Repo
uses: actions/checkout@v2
uses: actions/checkout@v4
with:
path: ${{github.event.repository.name}}
- name: Get Plugin's version
Expand Down Expand Up @@ -66,7 +66,7 @@ jobs:
echo "FILE_NAME=$file_name" | Out-File -FilePath $Env:GITHUB_ENV -Encoding utf-8 -Append
echo "TAG_NAME=$tag_name" | Out-File -FilePath $Env:GITHUB_ENV -Encoding utf-8 -Append
- name: Flow Launcher Cache
uses: actions/cache@v2
uses: actions/cache@v4
id: flow_cache
with:
path: |
Expand Down Expand Up @@ -95,10 +95,10 @@ jobs:
New-Item -ItemType SymbolicLink -Path $plugin_path -Target $repo_path
echo "PLUGIN_PATH=$plugin_path" | Out-File -FilePath $Env:GITHUB_ENV -Encoding utf-8 -Append
- name: Set up Python
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python_ver }}
- uses: actions/cache@v2
- uses: actions/cache@v4
with:
path: ~\AppData\Local\pip\Cache
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
Expand Down
75 changes: 75 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# 🌟 Browser History Plugin for Flow Launcher

The **Browser History Plugin** for Flow Launcher allows you to quickly search and access your browsing history across multiple browsers. Whether you're looking for a specific webpage or want to revisit recent sites, this plugin makes it easy to find what you need with just a few keystrokes.

## 📋 Features

- **Multi-Browser Support**: Access history from Chrome, Firefox, Edge, Brave, Opera, Vivaldi, Arc, Zen, Floorp, Thorium, Waterfox, and more.
- **Custom Profiles**: Add custom Chromium-based or Firefox-based browser profiles for personalized history retrieval.
- **Combined History**: Combine and sort history entries from all supported browsers into a single list.
- **Profile Selection**: Automatically select the most recently updated profile or manually specify one.
- **Domain Blocking**: Exclude specific domains from search results to filter out unwanted websites.

## 🚀 Installation

### Step 1: Install Flow Launcher
Make sure you have [Flow Launcher](https://www.flowlauncher.com/) installed on your system. If not, download and install it from the official website.

### Step 2: Install the Plugin
1. Open Flow Launcher and go to **Settings > Plugin Store**.
2. Search for "Browser History" in the store.
3. Click **Install** to add the plugin to your Flow Launcher setup.

Alternatively, you can manually install the plugin:
1. Download the latest release.
2. Extract the files and place the plugin folder in your Flow Launcher plugins directory: `%AppData%\FlowLauncher\Plugins`.
3. Restart Flow Launcher to load the new plugin.

### Step 3: Configure Settings
The defaults are okay for 99% of users. But if you want to change anything, just go to Flow Launcher plugin settings.

## ⚙️ Configuration

The plugin provides several settings to customize its behavior:

| Setting Name | Description | Default Value |
|:----------------------------------|:-----------------------------------------------------------------------------------------------|:---------------------:|
| **Choose a Browser or Profile** | Select the browser or profile to use by default. Choose **Chromium Profile** or **Firefox Profile** to target a specific profile directory. | `Chrome` |
| **Select the Most Recently Used Profile** | When enabled, the plugin selects the most recently updated profile for browsers that support multiple profiles. | `true` |
| **Path to Profile Folder** | Required ONLY if you select **Chromium Profile** or **Firefox Profile**. Must be a DIRECTORY (profile folder), not the History / places.sqlite file. | `N/A` |
| **Combine History from All Browsers** | When enabled, the plugin fetches and combines history from all supported browsers, including custom profiles. | `true` |
| **Number of History Items to Load** | Set the maximum number of history entries to fetch per browser. Decrease this value if you experience slowdowns. | `1000` |
| **Blocked Domains** | Comma-separated list of domains to exclude from search results (e.g., facebook.com, twitter.com). Leave empty to show all domains. | `N/A` |

## 🔧 Troubleshooting

### 1. Plugin Not Working
- Ensure that Flow Launcher has permission to access your browser's history database.
- Verify that the browser's profile folder exists and contains the required files (`History` for Chromium-based browsers, `places.sqlite` for Firefox).
- If using a custom profile: the path MUST be the folder containing the file, e.g.:
- Chromium: `%LocalAppData%\BraveSoftware\Brave-Browser\User Data\Default`
- Firefox: `%AppData%\Mozilla\Firefox\Profiles\xxxxxxxx.default-release`

### 2. Missing or Incorrect Results
- Check the plugin settings to ensure the correct browser or profile is selected.
- If using a custom profile, confirm that the provided path is a directory (not a file) and that it contains the expected database file.

### 3. Slow Performance
- Reduce the **History Limit** in the settings to fetch fewer entries.
- Disable **Combine History** if you only need results from a single browser.

### 4. Errors in Logs
- If you encounter errors, check the Flow Launcher logs for details: `%AppData%\FlowLauncher\Logs`
- For custom profiles, the error message will include the attempted database path—verify it exists.

## ❓ Reporting Issues

If you encounter any issues while using the plugin or have suggestions for improvement, please feel free to open an issue on GitHub:

1. Navigate to the **Issues** page.
2. Click **New Issue** and provide the following information:
- A clear description of the problem or feature request.
- Steps to reproduce the issue (if applicable).
- Any relevant error messages or logs from Flow Launcher.

> **Note**: Before opening a new issue, please check the existing issues to see if your problem has already been reported.
43 changes: 41 additions & 2 deletions SettingsTemplate.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,52 @@ body:
- type: dropdown
attributes:
name: default_browser
label: Default Browser
label: Choose a Browser or Profile
defaultValue: Chrome
options:
- Chrome
- Firefox
- Firefox Nightly
- Edge
- Brave
- Brave Nightly
- Opera
- Vivaldi
- Arc
- Arc
- Zen
- Floorp
- Thorium
- Helium
- Waterfox
- Chromium Profile
- Firefox Profile
- type: checkbox
attributes:
name: profile_last_updated
label: Select the Most Recently Used Profile
defaultValue: 'true'
- type: inputWithFolderBtn
attributes:
name: custom_profile_path
label: Path to Profile Folder
defaultValue: ''
description: Only needed if picked "Chromium Profile" or "Firefox Profile".
- type: checkbox
attributes:
name: all_browsers_history
label: Combine History from All Browsers
defaultValue: 'true'
- type: input
attributes:
name: history_limit
label: Number of History Items to Load
defaultValue: '1000'
description: This is the maximum number of history entries to load for each browser. The default is 1,000.
- type: textarea
attributes:
name: blocked_domains
label: Blocked Domains
defaultValue: ''
description: Comma-separated list of domains to exclude from search results. (e.g., facebook.com, twitter.com)


2 changes: 1 addition & 1 deletion plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"Name": "Browser History",
"Description": "Search your Web Browser history",
"Author": "Garulf",
"Version": "0.6.0",
"Version": "1.6.2",
"Language": "python",
"Website": "https://github.com/Garulf/browser-history",
"IcoPath": "./icon.png",
Expand Down
Loading
Loading