An open API service indexing awesome lists of open source software.

https://github.com/wysh3/zen-premium

This repository extends the functionality of Zen Browser a Firefox fork, by adding JavaScript support and enabling advanced customization options.
https://github.com/wysh3/zen-premium

firefox firefox-tweaks llama3-2 llama3-2-1b-model ollama ollama-api zen zen-browser zen-browser-mods

Last synced: 9 months ago
JSON representation

This repository extends the functionality of Zen Browser a Firefox fork, by adding JavaScript support and enabling advanced customization options.

Awesome Lists containing this project

README

          

# Zen/Firefox Browser Customization

A guide to customize your Zen/Firefox browser with enhanced features using custom scripts and additional tools.

## Prerequisites

Before you begin, ensure the following are set up:

1. **Enable Custom Scripts in Firefox**:
Follow the instructions in the **[fx-autoconfig repository](https://github.com/MrOtherGuy/fx-autoconfig)** to enable custom scripts in Firefox.

2. **Install Ollama**:
Download and install Ollama on your system from their **[official website](https://ollama.com/)**.
- Pull the `llama3.2:1b-instruct-q4_K_M` model using the Ollama interface.
- _(Note: You can use other models, but you'll need to modify the code accordingly.)_

## Installation Steps

### 1. Enable Custom Scripts in Firefox
- Follow the detailed steps provided in the **[fx-autoconfig repository](https://github.com/MrOtherGuy/fx-autoconfig)** to configure custom scripts in your browser.

### 2. Add Custom Features
- Copy the files from this repository to their respective folders inside your Firefox profile.
(Refer to the profile location guide if needed: `about:profiles` in Firefox.)

- Restart Zen/Firefox after clearing the **Startup Cache**:
Go to `about:support` → Click on **"Clear Startup Cache"**.

### 3. Test Your Customization
- Once restarted, your Zen/Firefox browser is ready to use with the newly added features.

## Features

- Enhanced customization of the Zen/Firefox interface.
- Integrated Ollama functionality with support for `llama3.2:1b-instruct-q4_K_M` or other models.
- Flexible architecture for adding further custom scripts and tools.

## Troubleshooting

- **Scripts Not Working?**
- Double-check that custom scripts are enabled correctly using the **[fx-autoconfig setup guide](https://github.com/MrOtherGuy/fx-autoconfig)**.
- Verify that all files are placed in the appropriate directories.

- **Startup Cache Issues?**
- Ensure you’ve cleared the **Startup Cache** from `about:support`.

- **Ollama Errors?**
- Confirm that the required `llama3.2:1b-instruct-q4_K_M` model is downloaded and installed properly.
- Edit the code to match your chosen model if it differs from `llama3.2:1b-instruct-q4_K_M`.

---

## Credits

- **Clear Button JavaScript**: Thanks to [Futuremappermydud](https://github.com/Futuremappermydud/lambda-zen/)

- **fx-autoconfig**: Thanks to [MrOtherGuy](https://github.com/MrOtherGuy/fx-autoconfig)

## License

This project is licensed under the [GPL-3.0 License](LICENSE).