rod.wright/OpenKiosk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 5 Wiki Activity

Adjustments to support workstation mode

Browse Source
This commit is contained in:
Rod Wright
2026-02-27 14:30:51 -05:00
parent 6dbb650431
commit 77a250ce08
14 changed files with 93 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
distfiles/etc/openkiosk/openkiosk.conf Normal file
View File

@@ -0,0 +1,42 @@
# openkiosk.conf
#
# Configuration file for OpenKiosk
# Debug flag. Set to 1 to cause openkiosk to output helpful
# information to ~/openkiosk.log.
# Set to 0 for production use, or the log could fill up your filesystem!
DEBUG="0"
# URL to load for the kiosk browser.
# This can be a website, specified like:
# http://somesite.com/somepage
# or a local file, specified like:
# file:/home/kioskuser/somefile.pdf
# If the URL ends with ".pdf", it will be opened using xpdf, otherwise
# it will be assumed to be of some format that can be displayed by a
# web browser.
# You can also use the word "test" which will cause OpenKiosk to
# start an xterm, which is useful for development and testing.
TGT_URL="test"
# Interval in seconds to poll the URL for changes.
# This should be enabled where the kiosk is used as a display for a file
# fetched from a URL. Do not use for an interactive kiosk.
# Set to 0 to disable polling or for an interactive kiosk.
POLL_INTERVAL="0"
# Display blanking is controlled by DPMS. For a display-only kiosk,
# set INHIBIT_BLANK to "1" to prevent screen blanking, ignoring the
# DSP parameters. If INHIBIT_BLANK is set to "0", the DSP parameters
# control the number of seconds for standby, suspend, and off modes.
# If you find that your display is going to sleep and not waking up, try
# setting the OFF and/or SUSP parameters to 0 which will disable them.
INHIBIT_BLANK="0"
DSP_STBY_SEC="600"
DSP_SUSP_SEC="1200"
DSP_OFF_SEC="1800"
# Display rotation. Can be used to control the orientation of the display.
# Values are one of "normal", "left", "right", or "inverted".
ROTATION="normal"

65
distfiles/etc/openkiosk/openkiosk_welcome.html Normal file
View File

@@ -0,0 +1,65 @@
<html>
<head>
<meta http-equiv=\"x-ua-compatible\" content=\"IE=edge\">
<title>OpenKiosk</title>
</head>
<body>
<h3 align="center">
OpenKiosk
</h3><br>
<table border="0" width="100%">
<tr>
<td align="center">Current version is <b>1.1.0</b></td>
</tr>
</table>
<br>
<p>
<b>Welcome</b><br>
Welcome to OpenKiosk. You are seeing this page because you have accepted the default URL during installation.
Obviously this is not very useful. To make it more useful, you'll need to edit the /etc/openkiosk/openkiosk.conf
file (if this is a standalone kiosk) or ~/.config/openkiosk/openkiosk.conf (if this is a workstation kiosk)
and adjust things for your needs.
</p>
<p>
<b>Configuration</b><br>
To edit this file, you'll either need to ssh into the kiosk machine or use
webmin. If you elected to install webmin during OpenKiosk installation, you can
<a href="https://localhost:10000"> click here </a> to access it, then use the
File Manager tool to navigate to /etc/openkiosk and edit the openkiosk.conf file.
The file contains descriptions of the available options.
<br>
For testing purposes, you can set the TGT_URL parameter in the openkiosk.conf file
to "test". This will give you an xterm window on the desktop.
<br>
Any changes made to the configuration file will be automatically detected and the
the kiosk will reload using the new configuration.
</p>
<p>
<b>Useful Key Combinations</b><br>
If this is a standalone kiosk, many of the normal key combinations have been disabled to prevent misuse of the kiosk.
However, there are two that you should know about.
<br>
Pressing &lt;alt&gt;-&lt;F4&gt; will kill and restart the display app, reloading the target URL.
<br>
Pressing &lt;ctrl&gt;-&lt;alt&gt;-&lt;shift&gt;-&lt;del&gt; will shut down the kiosk.
<br>
Pressing &lt;ctrl&gt;-&lt;alt&gt;-&lt;shift&gt;-&lt;ins&gt; will reboot the kiosk.
</p>
<p>
<b>License</b><br>
OpenKiosk is licensed under the terms of the <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>.
Click on the link
or see the LICENSE file in the distribution to read it.
<br><br>
OpenKiosk is Copyright (C) 2026 by Rod Wright.
<br>
</p>
</body>
</html>