webappify/README.rst

50 lines
1.7 KiB
ReStructuredText
Raw Permalink Normal View History

2017-05-17 21:35:21 +00:00
WebAppify
=========
|pypi| |license| |build|
2024-09-27 16:30:23 +00:00
WebAppify is a simple module to easily create your own desktop apps of websites. WebAppify uses PySide6 and QtWebEngine
for displaying the web page, and works on Python 3.10 and up.
2017-05-17 21:35:21 +00:00
To create your own desktop web app, import and set up the WebApp class.
.. code:: python
from webappify import WebApp
app = WebApp('OpenStreetMap', 'https://www.openstreetmap.org', 'osm.png')
app.run()
This will create a window with the website, using the icon provided.
2017-06-13 22:46:41 +00:00
.. note::
2024-09-27 16:30:23 +00:00
If your site needs Flash Player, you'll need the appropriate Flash Player plugin installed system-wide.
2017-06-13 22:46:41 +00:00
Additional Options
------------------
``can_minimize_to_tray``
''''''''''''''''''''''''
.. important::
This option was changed in version 0.4.0 from ``canMinimizeToTray`` to ``can_minimize_to_tray``. The old option
2024-09-27 16:30:23 +00:00
is still available, but is deprecated. It will be removed in 0.6.0.
To install a system tray icon, and minimize your application to the system tray, simply pass
``can_minimize_to_tray=True`` to the class and a tray icon will be installed with the necessary menu options.
2017-06-13 22:46:41 +00:00
.. code:: python
app = WebApp('OpenStreetMap', 'https://www.openstreetmap.org', 'osm.png', can_minimize_to_tray=True)
2017-06-13 22:46:41 +00:00
Clicking on the tray icon will show the window, while right-clicking will show the menu.
.. |pypi| image:: https://img.shields.io/pypi/v/WebAppify
:target: https://pypi.org/project/webappify/
.. |license| image:: https://img.shields.io/pypi/l/WebAppify
:target: https://git.snyman.info/raoul/webappify/src/branch/master/LICENSE
.. |build| image:: https://ci.snyman.info/api/badges/raoul/webappify/status.svg
:target: https://ci.snyman.info/raoul/webappify