Managed to install and use in Windows 10.

[Fedess1986]

After some time struggling with this app (which is interesting, and, now I could finally use I can say it's fantastic and very promising), I researched a lot and used Gemini IA to get help to install and use this script. Also I managed to automate some things I considered I needed (like procesing in batch ) with custom scripts made with python. So I just want to share my experience, just because I couldn't find a clear how-to use this.

1. Install Python 3.11, it needs to be 3.11, in my case used 3.11.9, the file is: python-3.11.9-amd64.exe; choose Cutom Install and verify that "pip" and "tcl/tk" are checked. Next screen: Install for all users. And choose where to install, in my case it was D:\Python311

2. When installing, no need to check set PATH (unless you want to, as I created a virtual environment for this version only, which is one of the next steps).

3. I created a virtual environment called ChadVenv. Open CMD, and then: D:\python311\python.exe -m venv D:\ChadVenv

4. Activate it: D:\Python311\ChadVenv\Scripts\activate

5. Install all the components/libraries:
   D:\Python311\ChadVenv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel (need to specify the entire path)
   and then
   pip install "Pillow>=10.0.0" nvector pint moviepy requests pynmea2
   and finally
   pip install gopro-overlay

Download "ffmpeg-release-essentials.zip" and uncompress to any working folder. I use: C:\FFmpeg
There you will find a "bin" folder.
It is needed to add that folder to the Windows Environmet. Click start, write "env" and choose "Edit the system environment variables". Then click on button "Environment Variables". On "System Variables" box look for "path" and double clic on it. Clic "New" and add "C:\FFmpeg\bin" (or your desired folder where FFmpeg binaries are).

Now go to CMD; activate the environment, in my case I run:
D:\Python311\ChadVenv\Scripts\activate
and it should work.

After I managed to make it work, I created the automation script.
It envolves also:

• editing the layouts (.xml files)
• editing the FFmpeg profiles (.json file)
• Editing the .py script itself

I share mine, which strictly works if your files are in the same Windows unit (D:) and folder as mine, and if the ffmpeg-profiles.json file is in C:\Users\YOUR_USER.gopro-graphics

I attached the file:
ffmpeg-profiles.json
and
Chad_Overlay.py

The Chad_Overlay.py scrits can run without activating the env (it is activated from this script).
It automates the generation of overlay with transparency only files, encoded in any format you want (should be available in ffmpeg-profiles.json) but I mostly use ProRes because it has transparency and can be used easily within Adobe Premiere.

It asks for: process one file or a batch folder (all files with .mp4 extension within a folder, that came from a Gopro , in my case I have a Hero11 Black and works).

If you choose one file (Manual mode): then you specify output res (choose option or enter a custom one), choose layout (you can create your own and it will appear here, there are many layouts that came by default with the app), choose profile (available on ffmpeg-profiles.json) and then a windows popup appears to choose the file to process and then to choose the output directory.

If you choose option 2 at the begining, it is similar but you only specify the input and output directory, and the other variables are choosen to, and will apply for all files.

I hope this helps someone, it might sound silly but as I said I coulnd't find a step by step guide for this. And I managed to create an almost-GUI for this :D

Chad_Overlay.py

ffmpeg-profiles.json

[time4tea]

Thanks for your interest in the software.

Did you find the Windows docs at docs/windows.md ?

Were they not useful? If not it would be great to understand where they are incorrect. I dont use Windows myself.

I like your UI!

[Fedess1986]

Did you find the Windows docs at docs/windows.md ?

Were they not useful? If not it would be great to understand where they are incorrect. I dont use Windows myself.

Yes I found the Windows docs but I was stuck and unable to install and start using it. I started using python this year, so maybe what I "discovered" is pretty obvious to other people, not to me. I didn't understand the cause of the error, and then I woulnd't know what to do next.

I tried again with the help of AI.
I asked Gemini and I don't know how but that IA has the information about how the app was constructed (maybe it reads all the code) and that it required specific version of the library Pillow (this line in step 5 was the key: pip install "Pillow>=10.0.0")
FYI, it also mentioned two specific commands (I can't remember them now) that changed in other version of Python (3.12 and newer) that probbly explain why it won't work with newer versions, under Win10.

I like your UI!

Thank you! And I love your tool!

I also made this script: Chad_Overlay_Preview.py which is essentially the same, but for testing mods in the layouts, so it just renders a 3 second of any video file you pick encoding in ProRes with transparency. (to see components size, positions, etc). I like playing with it.

I will (almost) always use this tool to create the overlay only, and I'm playing around right now to create some 1080p vertical video layout.

Chad_Overlay_Preview.py