🌟 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 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.