Skip to content

pyinstaller native translucent not working #4842

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
3 tasks done
h0uter opened this issue Jun 5, 2025 · 1 comment
Open
3 tasks done

pyinstaller native translucent not working #4842

h0uter opened this issue Jun 5, 2025 · 1 comment
Labels
analysis Status: Requires team/community input bug Type/scope: A problem that needs fixing

Comments

@h0uter
Copy link

h0uter commented Jun 5, 2025

First Check

  • I added a very descriptive title here.
  • This is not a Q&A. I am sure something is wrong with NiceGUI or its documentation.
  • I used the GitHub search to find a similar issue and came up empty.

Example Code

# macOS packaging support
from multiprocessing import freeze_support

freeze_support()  # noqa

from nicegui import app, ui

app.native.window_args["transparent"] = True
app.native.window_args["frameless"] = True


def main():
    with ui.card():
        ui.label("Hello, NiceGUI!")

    ui.run(
        reload=False,
        native=True,
    )


if __name__ in ("__main__", "__mp_main__"):
    main()

Description

window_args not respected with nicegui-pack

build the app using nicegui-pack

nicegui-pack --name mytest --windowed main.py

start the MacOS app by running

./dist/mytest.app/Contents/MacOS/mytest

The window shown is not transparent and not frameless.

I expected it to be frameless and transparent.

Running without pyinstaller works

If I run the app locally by running the python file.

The window shown is frameless and transparent.

NiceGUI Version

2.19.0

Python Version

3.13.3

Browser

Other

Operating System

macOS

Additional Context

using ui.run(frameless=True) works as expected

If I use the option ui.run(frameless=True) in my code

# macOS packaging support
from multiprocessing import freeze_support

freeze_support()  # noqa

from nicegui import app, ui

app.native.window_args["transparent"] = True

def main():
    with ui.card():
        ui.label("Hello, NiceGUI!")

    ui.run(
        reload=False,
        native=True,
        frameless=True
    )


if __name__ in ("__main__", "__mp_main__"):
    main()

and then build the app using nicegui-pack

nicegui-pack --name mytest --windowed main.py

start the MacOS app by running

./dist/mytest.app/Contents/MacOS/mytest

The window shown is frameless but not tranparent.

@evnchn evnchn added bug Type/scope: A problem that needs fixing analysis Status: Requires team/community input labels Jun 9, 2025
@falkoschindler
Copy link
Contributor

Thanks for reporting this issue, @h0uter! I can reproduce the problem, but have no idea what could be the reason.
Does anyone have an idea? Does it happen on macOS only?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
analysis Status: Requires team/community input bug Type/scope: A problem that needs fixing
Projects
None yet
Development

No branches or pull requests

3 participants