[Bug]: can not open on mac

[developerchq]

GridPlayer version

0.5.4

What OS are you using?

MacOS

OS Version / Linux distribution

macOS Sequoia

What distribution channel are you using? [LINUX ONLY]

None

Bug description

Traceback (most recent call last):
File "main.py", line 44, in
File "main.py", line 33, in main
File "gridplayer/main/run.py", line 14, in run_app
File "gridplayer/utils/libvlc.py", line 32, in init_vlc
File "gridplayer/utils/libvlc.py", line 85, in _get_vlc_version
File "contextlib.py", line 135, in enter
File "gridplayer/utils/libvlc_fixer.py", line 23, in importing_embed_vlc
RuntimeError: PYTHON_VLC_LIB_PATH not set

Log excerpt

[developerchq]

[ryan-utopia]

https://github.com/vzhd1701/gridplayer?tab=readme-ov-file#pipx

This type of installation will also require VLC installed (Windows & Mac) or a vlc package (Linux) present in your system. Please refer to VLC official page for instructions on how to install it.

Some distros (e.g. Ubuntu) might also require libxcb-xinerama0 package.

[ryan-utopia]

If you still encounter the PYTHON_VLC_LIB_PATH not found error even after installing VLC, here are two solutions:

Method 1: Set global variable via launchctl (Temporary)

This command allows the macOS GUI to "see" the environment variable. However, this setting will be lost after a system reboot.

1. Open Terminal and run the following command:

   launchctl setenv PYTHON_VLC_LIB_PATH /Applications/VLC.app/Contents/MacOS/lib/libvlc.dylib

2. Fully quit GridPlayer (force quit if necessary).
3. Launch GridPlayer from the icon/Dock, and it should work.

Note: You will need to run this command again every time you restart your computer.

---

Method 2: Create a Launcher using Automator (Permanent Solution - Recommended)

Since clicking the original app icon doesn't load the environment variables defined in your shell profile, you can create a wrapper application using macOS Automator.

1. Search for and open Automator on your Mac.
2. Choose New Document and select Application as the type.
3. In the search bar on the left, type shell and find Run Shell Script. Drag it to the workflow area on the right.
4. Delete any default text in the script box and paste the following code:

   export PYTHON_VLC_LIB_PATH=/Applications/VLC.app/Contents/MacOS/lib/libvlc.dylib
   open -a "GridPlayer"

5. Press Cmd + S to save.
   • Name: GridPlayer Launcher (or whatever you prefer).
   • Location: /Applications folder.
6. Use this new icon to launch the app from now on.

[hey-tommy]

1. With all due respect @ryan-utopia, neither of those are solutions — they are workarounds.
2. This issue is also present when installed from DMG directly (I upgraded from 0.5.3 — and yes, I've got the latest VLC player installed).
3. This is 100% a regression bug in 0.5.4 — this issue is NOT present in 0.5.3.