runkey-button user interface Files

A Runkey -for kiosk or console systems
Windows 10 Manual  so far

 a button user interface...


INTRODUCTION
============
This app lets the user 
press a key on keyboard key to run a shortcut or script that executes a program or command.

The user can then shut down or reboot the system.

No Graphical Interface needed after setup.

PURPOSE OF EXE FILES INCLUDED
============
runkey-win64lnk.exe - run shortcut files in the same folder named with a single letter, after the user pushes the appropriate key on the keyboard.
runkey-win64batch.exe - run batchfiles named with a single letter, after the user pushes the appropriate key on the keyboard.

examples: n.lnk, m.bat

HOW TO SETUP
============
Files and knowledge needed.

-How to use batch files.
How to create shortcuts
Safe practices for computer - turn on or off without writing to disk

ADMINISTRATOR USAGE
============
1.  The Adminstrator can create a painting or drawing of a keyboard map of the keys they want the user to use to open each program.
or tell the end user the keys to use for each program.
2.  the Admin will want to create single letter shortcuts or batch files the user can press to run a program.
for example create a windows shortcut key labled n.lnk for shortcut file to notepad.exe.
or p for paint (p.bat) batch folder and put in the same folder as the runkey program.
3.  The Admin will want to run either runkey-win64lnk.exe or runkey-win64batch.exe depending on what file type is created 

STANDARD USER USAGE
============
1.  Start the computer
2.  Press the key for the desired program.
3.  After using the program,  turn off or restart the computer

EXAMPLE WITH NOTEPAD.EXE AND A SHORTCUT FILE (create file: n.lnk)
============
create a folder with runkey-win64lnk.exe, and for example shortcut to notepad.exe labled as n.lnk
When you run runkey-win64lnk it will wait for a key press on the keyboard.
If you press n on the keyboard it will try to run n.lnk (this is the shortcut you created and put in the same directory.)

EXAMPLE WITH NOTEPAD.EXE AND A BATCH FILE (create file: m.bat)
============
create a folder with runkey-win64batch.exe, and for example shortcut to notepad.exe labled as n.bat
When you run runkey-win64batch it will wait for a key press on the keyboard.
If you press n on the keyboard it will try to run n.bat (this is the batch file you created and put in the same directory.)

you can then shut down or reboot the computer.  Also you could use a batch file or script to automate this.

EXAMPLE BATCH FILE (m.bat)
============
REM hello
pause





DOCUMENTATION
============
-  Basic linux and windows files on creation with March 14, 2023 version of chatgpt 3.5 is included.
-  Source files in C language version 99 are included for Windows 10 64-bit
- .png files of usage
Files Included:
Windows Binary exe
Linux and Windows source
Documentation and GPLv3 licensing.
Screenshots in Documentation folder of program running in Windows 10 console.


COMPILING
============
USED Embercardero Dev C++ with the C programming language for Windows 10 64-bit, gcc was used for linux.
Files were input with the .C extension.


Ideas...
============

This is from an idea I had to 

1.  make computers easier to use.
2.  Turn computers into an early tv console or sales kiosk like experience.
3.  Easy to use, no gui required after configured, but bui - button user interface.



CHANGELOG
============
6:32 PM 4/22/2023
Bug Win64 runkey for shortcuts -the program doesn't close until the shortcut refrenced does...

updated pictures in documentation added pictures.

2:20 PM 4/22/2023
Added batch file windows support, 

(3/24/23) /4/22/23
- corrected/updated linux  source file: runkeylinux.c, was able to compile on linux yesterday night will keep old file as runkeylinux.c.old in the Linux source of documentation.
more updates to documentation 
(3/23/23)
- corrected linux  source file and made character entered convert to lowercase filenames 
- updated some documentation