kaushik54git / transluminate

TransLuminate

TransLuminate is a Python application built using the Tkinter GUI toolkit. It features a customizable, translucent, click-through window overlay that helps in reducing eye strain by allowing users to dim their screens and apply colored filters. This tool is particularly useful for managing varying background brightness across different applications in Windows Desktop

Features

• Full-screen Overlay: Covers the entire screen with a translucent filter.
• Adjustable Transparency: A slider control allows users to adjust the transparency level of the overlay.
• Color Customization: Users can choose any color for the overlay to enhance visual comfort.
• Click-Through Capability: Allows interaction with applications underneath the overlay, without having to disable or close the overlay.
• Simple User Interface: Easy-to-use interface with a control panel for quick adjustments.

Stand Alone Application

1. Go to dist folder and downlaod the .exe file to execute and run the application

Installation [For personal Customization ]

To get started with TransLuminate, follow these steps:

1. Ensure you have Python installed on your system. Python 3.6 or higher is recommended.
2. Clone this repository:

git clone https://github.com/kaushik54git/TransLuminate.git

3. Navigate to the project directory:

cd TransLuminate

4. Install the required dependencies:

pip install -r requirements.txt

Usage

To run TransLuminate, execute the following command in the project directory:

python main_code.py

Upon launching, a control panel window will appear where you can adjust the transparency and choose the color settings. These settings will immediately apply to the fullscreen overlay.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

• Thanks to the Python and Tkinter communities for their invaluable resources.
• Hat tip to anyone whose code was used as inspiration or directly included.
• Special thanks to all contributors who help test, improve, and advance this project.

transluminate's Issues

Set Upper Limit for Transparency Slider

When the transparency slider is set to maximum, the entire screen becomes invisible, causing frustration among users who struggle to locate the slider. To prevent this issue, I suggest implementing an upper bound threshold on the slider's transparency setting.