https://github.com/srccircumflex/showcase-browser

This minimalistic program turns any website or other document into a stand-alone application.
https://github.com/srccircumflex/showcase-browser

browser gui html-gui minimalistic pyqt pyqt6 qt qt6 showcase website-to-app webview

Last synced: 25 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/srccircumflex/showcase-browser
• Owner: srccircumflex
• License: gpl-3.0
• Created: 2024-06-17T12:29:59.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2024-06-21T20:32:11.000Z (5 months ago)
• Last Synced: 2024-09-29T07:41:50.193Z (about 1 month ago)
• Topics: browser, gui, html-gui, minimalistic, pyqt, pyqt6, qt, qt6, showcase, website-to-app, webview
• Language: Python
• Homepage: https://pypi.org/project/showcase-browser/
• Size: 28.3 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
ShowCase Browser - v3

#####################

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

    :align: left

    :width: 120px

    :target: https://github.com/srccircumflex/ShowCase-Browser

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_.

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

    :align: center

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

.. _PyQt6: https://pypi.org/project/PyQt6/

.. _QtGroup: https://www.qt.io/

.. _chromium: https://www.chromium.org/Home/