https://github.com/indeadkiyo/linux-lens
its a simple script tool for image seaching and some other stuff (i'm trying to make the android Circle to Search for linux bec its really useful)
https://github.com/indeadkiyo/linux-lens
circle-to-search ocr-text-reader reverse-image-search
Last synced: about 2 months ago
JSON representation
its a simple script tool for image seaching and some other stuff (i'm trying to make the android Circle to Search for linux bec its really useful)
- Host: GitHub
- URL: https://github.com/indeadkiyo/linux-lens
- Owner: indeadkiyo
- License: mit
- Created: 2026-04-03T20:07:17.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-23T07:11:51.000Z (2 months ago)
- Last Synced: 2026-04-23T09:11:54.044Z (2 months ago)
- Topics: circle-to-search, ocr-text-reader, reverse-image-search
- Language: Python
- Homepage:
- Size: 8.22 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# linux-lens
> the Android Circle to Search. is really usefull so i wanted one for my linux to
:
> made it to work with any distro since mostly relay on py and not system api's
:
> the code is open so if there is bugs or etc you can modify it yourself or tell me and i can try to fix it
---
## What this is:
A desktop app that lets you:
1. Draw a little rectangle on your screen
2. Either **search** what's inside or run **OCR** to get the text (ps:offline so use that for privet stuff)
Built because I wanted to learn. Also because I'm too lazy to type text on images myself.
3. [test-vid](https://github.com/indeadkiyo/linux-lens/blob/main/test-2.mp4)
---
## Features (that actually work... mostly)
- Search via ImgOps | ✅
- OCR text extraction | ✅
- Dark mode | ✅ |there only dark mode|
- speech to text | ✅ (only test file)
- Translator | ❌ | future me's problem |
---
## how to add the bin file :
- look for where the shortcut in your windows manager is(eg: kde):
- settings -->keyboard-->shortcut--> select add new and set up the key you want
- idk others just search it up online
---
## What you need installed (no skipping)
- Python
- Poetry (https://python-poetry.org/)
- (ps: if you want you can set up all the packages yourself but poetry makes it a little easer)
- pyTesseract (the OCR brain)
- linux (idk if you experienced this problem but if you see a error based on tk then install tkinter in your os)
**This is required. your lap is lazy without it.**
```bash
# macOS (bless your heart)
brew install tesseract
# Ubuntu/Debian
sudo apt install tesseract-ocr
(or search your tesseract arch or fedora online you get the package name)
# Windows (my condolences)
# Download from: https://github.com/UB-Mannheim/tesseract/wiki
# Add to PATH or we'll have problems
```
### 3. Python packages (handled by poetry but here's the list)
```
customtkinter
Pillow
pytesseract
opencv-python
requests
```
---
## dev :
## 🐛 Known bugs (aka: im to lazy to fix )
- Tesseract sometimes is not really good at formatting
- code is not pritty
- idk how it even runs at this point it just does
- there a timer in the test file to test stuff so if you want it to work instant remove that
- not good for copying code from image or format's like that since may goal was to make it lightwaight i had to give up on accuracy a little
---
---
## Credits
- **Me** – for the bad ideas and worse code
- **GPT** – for fixing my GUI so it doesn't look like Windows XP
- **tea** – for existing
- **Ikaros** – go watch Heaven's Lost Property you will know what i mean its peak
---
## License
Do whatever you want. Learn from it. Break it. Fix it. Make it better.
Just don't blame me if it didnt work
---
