/ShowCase-Browser

This minimalistic program turns any website or other document into a stand-alone application.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

ShowCase Browser - v3

https://raw.githubusercontent.com/srccircumflex/docs/main/showcase-logo.png

This minimalistic program turns any website or other document into a stand-alone application.

Coded with the PyQt6 package (The QtGroup) and powered by chromium.

https://raw.githubusercontent.com/srccircumflex/docs/main/sep.png

Install and Run

Use the module pip to install the showcase_browser package:

python -m pip install showcase-browser --upgrade

This installs all the required packages and creates the shell command

showcase

and you can execute:

showcase github.com
See also Troubleshooting

Features

All optional features are deactivated by default.

For an overview of the command line parameters execute:

showcase --help

Examples

Add Browser Basis Widgets

showcase github.com --wg-url --wg-back --wg-forward --wg-refresh --wg-stop --wg-home --home-url google.com

Add Browser Tabs

showcase github.com --wg-tabs --wg-tabs-close --wg-tabs-add --tabs-default-url google.com --tabs-dynamic-labels --tabs-keep-last

Communicator

For the possibility to use showcase dynamically in scripts, a socket is installed with the flag --com which enables remote control from another process.

showcase github.com --com --window-title "my app" --window-maxsize

Now some commands can be executed from another process (Shell/Terminal/Cmd) to control the showcase.

showcase https://pypi.org/ --com-try

Troubleshooting

Under Linux, the following error may occur during execution:

qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: wayland-egl, xcb, vkkhrdisplay, wayland, vnc, linuxfb, offscreen, eglfs, minimal, minimalegl.

Fix it by installing the required packages:

sudo apt-get install -y libxcb-cursor-dev