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/
Raw data
{
"_id": null,
"home_page": null,
"name": "showcase-browser",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ui, giu, app, showcase, browser, minimalistic, website to app",
"author": null,
"author_email": "\"Adrian F. Hoefflin\" <srccircumflex@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/03/10/66efc9fa91916188838316db76a56712c128c5100b5e54d47344bda72eb8/showcase_browser-0.1.3.2.tar.gz",
"platform": null,
"description": "ShowCase Browser - v3\n#####################\n\n\n.. image:: https://raw.githubusercontent.com/srccircumflex/docs/main/showcase-logo.png\n :align: left\n :width: 120px\n :target: https://github.com/srccircumflex/ShowCase-Browser\n\nThis minimalistic program turns any website or other document into a stand-alone application.\n\nCoded with the PyQt6_ package (The QtGroup_) and powered by chromium_.\n\n.. image:: https://raw.githubusercontent.com/srccircumflex/docs/main/sep.png\n :align: center\n\nInstall and Run\n***************\n\nUse the module ``pip`` to install the ``showcase_browser`` package:\n\n::\n\n python -m pip install showcase-browser --upgrade\n\nThis installs all the required packages and creates the shell command\n\n::\n\n showcase\n\nand you can execute:\n\n::\n\n showcase github.com\n\n..\n\n See also Troubleshooting_\n\n\nFeatures\n********\n\nAll optional features are deactivated by default.\n\nFor an overview of the command line parameters execute:\n\n::\n\n showcase --help\n\n\nExamples\n========\n\nAdd Browser Basis Widgets\n-------------------------\n\n::\n\n showcase github.com --wg-url --wg-back --wg-forward --wg-refresh --wg-stop --wg-home --home-url google.com\n\nAdd Browser Tabs\n----------------\n\n::\n\n showcase github.com --wg-tabs --wg-tabs-close --wg-tabs-add --tabs-default-url google.com --tabs-dynamic-labels --tabs-keep-last\n\n\nCommunicator\n------------\n\nFor the possibility to use ``showcase`` dynamically in scripts, a socket is\ninstalled with the flag ``--com`` which enables remote control from another process.\n\n::\n\n showcase github.com --com --window-title \"my app\" --window-maxsize\n\nNow some commands can be executed from another process (Shell/Terminal/Cmd) to control the ``showcase``.\n\n::\n\n showcase https://pypi.org/ --com-try\n\nTroubleshooting\n***************\n\nUnder Linux, the following error may occur during execution::\n\n qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.\n qt.qpa.plugin: Could not load the Qt platform plugin \"xcb\" in \"\" even though it was found.\n This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.\n\n Available platform plugins are: wayland-egl, xcb, vkkhrdisplay, wayland, vnc, linuxfb, offscreen, eglfs, minimal, minimalegl.\n\nFix it by installing the required packages::\n\n sudo apt-get install -y libxcb-cursor-dev\n\n\n\n\n\n.. _PyQt6: https://pypi.org/project/PyQt6/\n.. _QtGroup: https://www.qt.io/\n.. _chromium: https://www.chromium.org/Home/\n\n",
"bugtrack_url": null,
"license": "GPL v3",
"summary": "Minimalistic Browser / Website to App / Showcase App",
"version": "0.1.3.2",
"project_urls": {
"Homepage": "https://github.com/srccircumflex/ShowCase-Browser"
},
"split_keywords": [
"ui",
" giu",
" app",
" showcase",
" browser",
" minimalistic",
" website to app"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0941ea582eb0ef7f3f5eb0701eadcebd5f239e68d7c50435c53dfb1fb27d1495",
"md5": "19da83f8ec0505dfdd340bce065f8429",
"sha256": "45c2073514d53f941e2759f2542b1bb88200e06e6a581c8047d457e0fd688e0b"
},
"downloads": -1,
"filename": "showcase_browser-0.1.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19da83f8ec0505dfdd340bce065f8429",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 48270,
"upload_time": "2024-06-23T16:56:11",
"upload_time_iso_8601": "2024-06-23T16:56:11.517525Z",
"url": "https://files.pythonhosted.org/packages/09/41/ea582eb0ef7f3f5eb0701eadcebd5f239e68d7c50435c53dfb1fb27d1495/showcase_browser-0.1.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "031066efc9fa91916188838316db76a56712c128c5100b5e54d47344bda72eb8",
"md5": "7a6c45551295e903f2ee196cc076fc96",
"sha256": "e7c723f4bb623efc4748e70faace538258dd9ab566a0a6f1b0ff36033d109feb"
},
"downloads": -1,
"filename": "showcase_browser-0.1.3.2.tar.gz",
"has_sig": false,
"md5_digest": "7a6c45551295e903f2ee196cc076fc96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 45923,
"upload_time": "2024-06-23T16:56:13",
"upload_time_iso_8601": "2024-06-23T16:56:13.668833Z",
"url": "https://files.pythonhosted.org/packages/03/10/66efc9fa91916188838316db76a56712c128c5100b5e54d47344bda72eb8/showcase_browser-0.1.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-23 16:56:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "srccircumflex",
"github_project": "ShowCase-Browser",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "showcase-browser"
}
JSON
