██╗      █████╗ ██╗   ██╗███████╗██████╗      ██████╗ ███╗   ██╗███████╗
██║     ██╔══██╗╚██╗ ██╔╝██╔════╝██╔══██╗    ██╔═══██╗████╗  ██║██╔════╝
██║     ███████║ ╚████╔╝ █████╗  ██████╔╝    ██║   ██║██╔██╗ ██║█████╗  
██║     ██╔══██║  ╚██╔╝  ██╔══╝  ██╔══██╗    ██║   ██║██║╚██╗██║██╔══╝  
███████╗██║  ██║   ██║   ███████╗██║  ██║    ╚██████╔╝██║ ╚████║███████╗
╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝     ╚═════╝ ╚═╝  ╚═══╝╚══════╝

Description

Set an image, an overlay top level front of all windows and its the opacity / dimension + clic trough, in a Python script.

This little tool create a window to load a picture who will overlay everything, drived by its command's board.

Useful for 3D artists who have to modelize with layers on software who are not giving this possibility, like metahuman from unreal engine, or else.

Also for pc gamers who would like to reproduce people in game, but also for science, for improving other projects. Or simply to win your pixel war.

I've integrated this overlay to my autoclicker if you're searching for both : https://github.com/SECRET-GUEST/autoclicker

ⁿᵒᵗᵉ : Bad anti-malware will returns false positive for the .exe file since it is not signed, however you have the code and I even wrote a guide on how to compile the program yourself in tutorial's section.

If you upload big pictures, it will slow the process so maybe you should try to manage the size first.

ⁿᵒᵗᵉ : Obviously cannot work on not windwoed games or whatever else also putting things in top position.

ⁿᵒᵗᵉ : Don't rage, you still can set position by using page up&down keys.

Fonts :

• Rivana : https://www.dafont.com/rivanna.font
• Uncial antiqua : https://www.dafontfree.io/uncial-antiqua-font/
• Terminal windows (Cascadia code) : https://www.fontsquirrel.com/fonts/cascadia-code

💎 Recommendations

If you're in need of more tools to bolster your desktop productivity, you might find these repositories useful:

• Font Lister : Compile a list of all your fonts, complete with images.
• FFMPEG Assembler : Generate videos in a single click.
• Barcraft : Create barcodes/QRCodes using an application free from malware, sourced directly from GitHub.

For more handy, GUI-free scripts, visit:

• Tiny Scripts

If you're a 3D animator, consider:

• Animation

📜 License

This software is released under the GNU General Public License v3.0 (GPL-3.0). Please see the LICENSE file for more information.

❓ Support & Questions

If you have any questions or need support, please feel free to open an issue or join my twitter.

██   ██  ██████  ██     ██     ████████  ██████      ██████  ██    ██ ███    ██ 
██   ██ ██    ██ ██     ██        ██    ██    ██     ██   ██ ██    ██ ████   ██ 
███████ ██    ██ ██  █  ██        ██    ██    ██     ██████  ██    ██ ██ ██  ██ 
██   ██ ██    ██ ██ ███ ██        ██    ██    ██     ██   ██ ██    ██ ██  ██ ██ 
██   ██  ██████   ███ ███         ██     ██████      ██   ██  ██████  ██   ████ 

Here's a tutorial explaining different ways to run the files:

For MAC & Linux users:

Since this script is designed for Windows users, you should probably first improve the code.

However, here is the procedure to run the script:

• 💻: [MAC] - https://macosx-faq.com/how-to-run-python-script/
• ⌨️ [LINUX] - open a terminal, then cd to the script's directory and type:

python script.pyw

(where script.pyw is obviously the name of the file you've downloaded)

🖥️ For Microsoft users:

Most of the time you can find an MSI installer in source forge, or in latest relase here, but if you don't you can still watch this tutorial.

Because this script is made by PyInstaller, it could be detected as malware. (sorry, but I will not spend money to just be approved by "security" software/websites, you have the code, and here are possibilities to help you run it:

🔶 1. Run by simple click on APPLICATION.exe

The .exe file is a portable version created for Microsoft users with PyInstaller, allowing you to download and use this file alone, without any additional files.

If there is no .exe file available, it means that the application is stored in a directory, as a portable version is not provided. In this case, simply locate the APP_NAME.exe file within the directory and launch it with a single click. You can place the folder anywhere you like and create a shortcut to the executable file for easy access.

🔶 2. Run with Python

Python script is a directory with the original script for python 3.11.

In case you have a lower version, you may have to download module imported not included with your version. Just read the first lines of the script in Alexandria with a notepad or whatever to find what's missing.

If you would like to run with python YOU WILL NEED THE IMAGE .png PLACED IN THE SAME DIRECTORY OF THE RUNNING SCRIPT.

Also, you can add a w to the extension (like script.pyw). It means windowed mode, to launch the python script without the CMD, but it's still a common python file.

🔶 3. Compile the script by yourself

⚙️ Instructions ⚙️

To create your own executable from the python file, you will need to install pyinstaller and python.

Here are the steps you should follow:

🔺 Download python 3.11.1

Don't forget to add it to your path with the installer or in variables environment (so reboot your PC after the installation), here is the link:

🎌 https://www.python.org/ftp/python/3.11.1/python-3.11.1-amd64.exe 🎌

🔺 Open your CMD as an administrator and type the following command:

python -m pip install pyinstaller

🔺 You can now run it using a ruby .spec file by entering the following command in the project directory:

pyinstaller YOUR_FILE.spec

Normally, I place a blank.spec file in the "script" folder, if there isn't one let's watch over here:

🎌 HOW TO MAKE AN EXECUTABLE FAST 🎌

🔺 You can also run it directly with your OS, type the following command, replacing the file paths with your own:

pyinstaller --onefile --icon="...YOUR PATH.../YOUR ICON.ico" --add-data "...YOUR PATH.../ico;ico" --noconsole test.py

Here are the explanations of the different options:

• --onefile: creates a single executable that includes all dependencies.

• --icon=icon.ico: specifies the icon to use for the executable (replace icon.ico with the path to your icon file).

• --add-data "path/to/file;folder_name": adds external files required by the program. The path to the file and the name of the folder in which the file will be extracted should be separated by a semicolon ;. You can add multiple files by separating them with semicolons.

• script.py: specifies the name of your Python script.

• --noconsole: hides the console when the executable is run.

Make sure to replace the snipped parts with the names of your files and folders. Also note that the path should be specified based on the operating system you are working on.

After running this command, you should have a single executable that includes all dependencies, external files, and a custom icon, and does not show the console when running.

Alternatively, you can also :

🔶 4. Create a batch file to run

• Create a text file

• In the text file type and write (and change/complete the path, first is for python, 2nd is for script.py):

C:\YOUR PATH TO PYTHON\python.exe" "C:\**YOUR PATH TO THE SCRIPT**\script.pyw"

If Python is in the path, you can just:

python "C:\**YOUR PATH TO THE SCRIPT**\script.pyw"

• Rename the new_file.txt to script.bat then just click on it, and it will run the program

     _ ._  _ , _ ._            _ ._  _ , _ ._    _ ._  _ , _ ._      _ ._  _ , _ .__  _ , _ ._   ._  _ , _ ._   _ , _ ._   .---.  _ ._   _ , _ .__  _ , _ ._   ._  _ , _ ._      _ ._  _ , _ .__  _ , _ . .---<__. \ _
   (_ ' ( `  )_  .__)        (_ ' ( `  )_  .__ (_ ' ( `  )_  .__)  (_ '    ___   ._( `  )_  .__)  ( `  )_  .__)   )_  .__)/     \(_ ' (    )_  ._( `  )_  .__)  ( `  )_  .__)  (_ ' ( `  )_  ._( `` )_  . `---._  \ \ \
 ( (  (    )   `)  ) _)    ( (  (    )   `)  ) (  (    )   `)  ) _ (  (   (o o) )     )   `)  ) _    )   `)  ) _    `)  ) \.@-@./(  (    )   `)     )   `)  ) _    )   `)  ) _ (  (    )   `)         `) ` ),----`- `.))  
(__ (_   (_ . _) _) ,__)  (__ (_   (_ . _) _) _ (_   (_ . _) _) ,__ (_   (  V  ) _) (_ . _) _) ,_  (_ . _) _) ,_ . _) _) ,/`\_/`\ (_   (  . _) _) (_ . _) _) ,_  (_ . _) _) ,__ (_   (_ . _) _) (__. _) _)/ ,--.   )  |
    `~~`\ ' . /`~~`           `~~`\ ' . /`~~`   `~~`\ ' . /`~~`     `~~`/--m-m- ~~`\ ' . /`~~`   `\ ' . /`~~`  `\ ' . /  //  _  \\ ``\ '  . /`~~`\ ' . /`~~`   `\ ' . /`~~`     `~~`\ ' . /`~~`\ ' . /`~~/_/    >     |
         ;   ;                     ;   ;             ;   ;               ;   ;      ;   ;          ;   ;         ;   ;  | \     )|_   ;    ;      ;   ;          ;   ;               ;   ;      ;   ;    |,\__-'      |
         /   \                     /   \             /   \               /   \      /   \          /   \         /   \ /`\_`>  <_/ \  /    \      /   \          /   \               /   \      /   \     \__         \
________/_ __ \___________________/_ __ \___________/_ __ \______ __ ___/_ __ \____/_ __ \________/_ __ \_______/_ __ \\__/'---'\__/_/_  __ \____/_ __ \________/_ __ \_____ _______/_ __ \____/_ __ \____ __\___      )