[PR #1286] [MERGED] Updates, Features, and Bugfixes; Oh My! #1150

New issue

Closed

opened 2026-02-25 21:30:20 +03:00 by kerem · 0 comments

kerem commented

2026-02-25 21:30:20 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/benbusby/whoogle-search/pull/1286
Author: @Don-Swanson
Created: 12/29/2025
Status: ✅ Merged
Merged: 12/29/2025
Merged by: @Don-Swanson

Base: main ← Head: updates

📝 Commits (5)

ff3a44b Refactor configuration and session management in the application
6c7ca7c - Add modern Google Images parsing (udm=2) and use view_image to render extracted image results, with Chrome UA and forced image endpoint for tbm=isch/udm=2.
9c5b315 Add method to remove AI Overview sections from search results
4852e5b Implement Google Custom Search (BYOK) feature with configuration options and API client
255f1a2 Bump version to 1.2.2

📊 Changes

15 files changed (+1150 additions, -108 deletions)

View changed files

📝 README.md (+104 -7)
📝 app/__init__.py (+53 -15)
📝 app/filter.py (+228 -22)
📝 app/models/config.py (+35 -3)
📝 app/request.py (+45 -13)
📝 app/routes.py (+80 -28)
➕ app/services/cse_client.py (+452 -0)
📝 app/static/widgets/calculator.html (+5 -2)
📝 app/templates/imageresults.html (+29 -5)
📝 app/templates/index.html (+24 -0)
📝 app/utils/search.py (+90 -4)
📝 app/version.py (+2 -2)
📝 docker-compose.yml (+2 -3)
📝 requirements.txt (+1 -1)
📝 whoogle.template.env (+0 -3)

📄 Description

This pull request introduces several improvements and fixes to both the documentation and the core filtering logic of the application. The most notable changes include the addition of support and documentation for Google Custom Search (BYOK), enhanced session key management for better security, and new filtering features to remove unwanted elements (such as AI Overview results and stray dark theme toggles) from search results. The code also improves the handling and styling of search results for clarity and consistency.

Documentation updates:

Added a comprehensive section to README.md describing how to use Google Custom Search (BYOK), including environment variables, setup instructions, pricing, limitations, and troubleshooting.
Updated the table of contents in README.md to include the new BYOK section and adjusted numbering for clarity. [1] [2]
Clarified environment variable documentation, removing duplicate/unnecessary entries.

Security and configuration:

Refactored session secret key management in app/__init__.py to prioritize environment variable, then file, then generate a new key, with validation and warnings for short or missing keys.
Added comments and improved path handling for static files and session configuration. [1] [2]

Search result filtering and UI improvements:

Implemented a new filter to remove Google's AI Overview/SGE results from search results, improving privacy and relevance. [1] [2]
Added logic to remove stray "Dark theme" toggle fragments from the footer, preventing broken UI elements. [1] [2]
Enhanced CSS styling for desktop search results to ensure consistent width and padding across result types.

Code quality and robustness:

Improved type checks and error handling in filter methods, such as sanitize_div, for greater reliability.
Updated imports and minor code cleanups for better maintainability. [1] [2]

These changes collectively improve the application's usability, reliability, and maintainability.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/benbusby/whoogle-search/pull/1286 **Author:** [@Don-Swanson](https://github.com/Don-Swanson) **Created:** 12/29/2025 **Status:** ✅ Merged **Merged:** 12/29/2025 **Merged by:** [@Don-Swanson](https://github.com/Don-Swanson) **Base:** `main` ← **Head:** `updates` --- ### 📝 Commits (5) - [`ff3a44b`](https://github.com/benbusby/whoogle-search/commit/ff3a44b91e46b93a7799e068b7719d12244a11f0) Refactor configuration and session management in the application - [`6c7ca7c`](https://github.com/benbusby/whoogle-search/commit/6c7ca7c082c915cc41f1b07a8df4ecac7e1046c6) - Add modern Google Images parsing (udm=2) and use view_image to render extracted image results, with Chrome UA and forced image endpoint for tbm=isch/udm=2. - [`9c5b315`](https://github.com/benbusby/whoogle-search/commit/9c5b3150aa441312216264ceb8624dcf8147509d) Add method to remove AI Overview sections from search results - [`4852e5b`](https://github.com/benbusby/whoogle-search/commit/4852e5b64f516083907bea104ceff19c9abaf1b9) Implement Google Custom Search (BYOK) feature with configuration options and API client - [`255f1a2`](https://github.com/benbusby/whoogle-search/commit/255f1a2c12ecedd03b2d1de97f7a52686776116d) Bump version to 1.2.2 ### 📊 Changes **15 files changed** (+1150 additions, -108 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+104 -7) 📝 `app/__init__.py` (+53 -15) 📝 `app/filter.py` (+228 -22) 📝 `app/models/config.py` (+35 -3) 📝 `app/request.py` (+45 -13) 📝 `app/routes.py` (+80 -28) ➕ `app/services/cse_client.py` (+452 -0) 📝 `app/static/widgets/calculator.html` (+5 -2) 📝 `app/templates/imageresults.html` (+29 -5) 📝 `app/templates/index.html` (+24 -0) 📝 `app/utils/search.py` (+90 -4) 📝 `app/version.py` (+2 -2) 📝 `docker-compose.yml` (+2 -3) 📝 `requirements.txt` (+1 -1) 📝 `whoogle.template.env` (+0 -3) </details> ### 📄 Description This pull request introduces several improvements and fixes to both the documentation and the core filtering logic of the application. The most notable changes include the addition of support and documentation for Google Custom Search (BYOK), enhanced session key management for better security, and new filtering features to remove unwanted elements (such as AI Overview results and stray dark theme toggles) from search results. The code also improves the handling and styling of search results for clarity and consistency. **Documentation updates:** * Added a comprehensive section to `README.md` describing how to use Google Custom Search (BYOK), including environment variables, setup instructions, pricing, limitations, and troubleshooting. * Updated the table of contents in `README.md` to include the new BYOK section and adjusted numbering for clarity. [[1]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L43-R45) [[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L53-R57) * Clarified environment variable documentation, removing duplicate/unnecessary entries. **Security and configuration:** * Refactored session secret key management in `app/__init__.py` to prioritize environment variable, then file, then generate a new key, with validation and warnings for short or missing keys. * Added comments and improved path handling for static files and session configuration. [[1]](diffhunk://#diff-9cec7b11237bc29d77a439e81c9b7acfac003d8e8855731eb6bc130b5a8ce602R15-R27) [[2]](diffhunk://#diff-9cec7b11237bc29d77a439e81c9b7acfac003d8e8855731eb6bc130b5a8ce602L79-R82) **Search result filtering and UI improvements:** * Implemented a new filter to remove Google's AI Overview/SGE results from search results, improving privacy and relevance. [[1]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eR327-R368) [[2]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eR163) * Added logic to remove stray "Dark theme" toggle fragments from the footer, preventing broken UI elements. [[1]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eR300-R315) [[2]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eR213-R215) * Enhanced CSS styling for desktop search results to ensure consistent width and padding across result types. **Code quality and robustness:** * Improved type checks and error handling in filter methods, such as `sanitize_div`, for greater reliability. * Updated imports and minor code cleanups for better maintainability. [[1]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eL8-R9) [[2]](diffhunk://#diff-3e2bd2993504b91c380d08a9348366d641576642c02b10c42318edeece46365eL555-L557) These changes collectively improve the application's usability, reliability, and maintainability. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>