Difference between revisions of "OpenTC"

From DanIT
Jump to navigation Jump to search
m
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
OpenTC is an open-source login portal for Windows that replaces the default Windows Explorer Shell. It enables the end user to solely connect to given Remote Desktop environments, and prevents them from accessing the desktop and other features.
+
==About==
 +
[[File:OpenTC Login.png|thumb|right]]
 +
OpenTC is login portal for Remote Desktop Connections on Windows, it replaces the default shell and explorer.<br>
 +
It provides end-users with a closed environment, and prevents them from accessing features outside the Remote Desktop connection.<br>
 +
This project has been setup as a free and open-source alternative to professionalize using Thin Clients.<br>
  
−
==Features==
+
[[OpenTC Development]]
−
* Set a custom logo, background, and theme color.
 
−
* Support-button tells users how to contact support, provides them with useful information for the engineer.
 
−
* Add Remote Desktop environments for the user to choose from, by simply uploading .rdp files to the computer.
 
−
* Users no longer have to login to a default user on a Thin Client, nor having to load the Desktop and manually click an RDP-icon.
 
−
* Prevents users from accessing the desktop, start menu, and other Windows features.
 
−
* It is still possible to access the desktop for administrative purposes (password required).
 
  
−
=Downloads=
+
===Features===
−
Client: (v0.1a)<br>
+
* Provide a closed environment for the user dedicated to connect to one or multiple Remote Desktop farms or server.
−
Server: N/A<br>
+
* Prevents users from accessing the local desktop, start menu, and other Windows features.
−
Sourcecode:<br>
+
* Add Remote Desktop environments for the user to choose from, by simply uploading .rdp files to the client.
−
Changelog:<br>
+
* A support button provides users with useful information, like how to contact local support and computer specifications.
 +
* Background image and logo are easily changable.
 +
* Dynamically and easily be able to change settings, images, and language. 
 +
* The client can be remote controlled ([[Remote_Desktop_shadowing|shadowed]]) by administrators for support or administrative purposes.
 +
* Administrators can still access the default desktop when needed.
 +
* Lightweight (0% CPU, 10mb memory, 50kb storage).
 +
* Free and open-source
  
−
=Setup=
+
===Requirements===
 +
* Windows 7 or higher
 +
* .NET Framework 2.0
 +
* PowerShell 5.1 (for setup script)
  
−
===Settings===
+
==Downloads==
−
During the setup you will be able to configure some settings, these settings are stored in the registry under the key "''HKEY_LOCAL_MACHINE\SOFTWARE\OpenTC\Client\Settings''".<br>
+
'''OpenTC v1.0''': <br>
 +
'''OpenTC v1.0 Source Code''': <br>
 +
 
 +
==Settings==
 +
The settings are stored in the registry under the key "''HKEY_LOCAL_MACHINE\SOFTWARE\OpenTC''".<br>
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
! Name !! Value
+
! Setting !! Description !! Value
 +
|-
 +
| Background || Path to the background image || e.g. "C:\Background.jpg"
 +
|-
 +
| Logo || Path to the logo image || e.g. "C:\Logo.jpg"
 +
|-
 +
| Language || Path to the language file || e.g. "C:\English.txt"
 
|-
 
|-
−
| Background || Path to the background image (e.g. "background.jpg")
+
| RDP || Path to the folder with the .rdp file(s) || e.g. "C:\RDP\"
 +
|-
 +
| Power || Power button behaviour || "Disabled", "Shutdown", or "Restart"
 +
|}
 +
When using no full directory path, it will automatically look for the file or folder in the same directory as the executable.
 +
 
 +
===Images===
 +
The background image will be shown on all monitors, and will be automatically stretched to fit the screen.<br>
 +
The logo image must be provided in 400x100 resolution.<br>
 +
 
 +
===Language===
 +
All translations of text and buttons are located in a text file. Language file 'English.txt' comes included.
 +
 
 +
===Support===
 +
The text in the support dialog is changable by editing "HELPTEXT" in the Language file.<br>
 +
You can use these environment variables:
 +
{| class="wikitable"
 
|-
 
|-
−
| Logo || Path to the logo image (e.g. "logo.jpg")
+
! Variable !! Result
 
|-
 
|-
−
| Language || Path to the language file (e.g. "english.txt")
+
| \n || A new line
 
|-
 
|-
−
| Mode || 0 = Standalone, 1 = Server, 2 = Server + Smart Card
+
| %HOSTNAME% || Hostname
 
|-
 
|-
−
| Server || When on server mode, enter IP:Port (e.g. "10.0.0.1:1234")
+
| %IP% || IP
 
|-
 
|-
−
| ShutDown || Allow client to be shut down, 0 = Disabled, 1 = Enabled
+
| %MAC% || MAC
 
|}
 
|}
−
With path values you may use only the filename and extension if they are located next to the OpenTC executable, use the full path if they are stored at another location.
+
You can hide the support button by changing the "HELP" text translation to be empty.<br>
 +
 
 +
===RDP===
 +
The Remote Desktop connections that the user can select from are all the .rdp files from the RDP folder.<br>
  
−
===Language===
+
Make sure the following settings have been applied for .rdp files:
−
Every text and button that is located within OpenTC is changable, you can open the ''english.txt'' file that is provided with the client and change things as you like.<br>
+
{| class="wikitable"
−
Ultimately you could create multiple language files and have certain clients use other text, by changing their "Language" registry value to the specific file name.<br>
+
|-
 +
! Setting !! Value !! File Value
 +
|-
 +
| ''User name'' || yourdomainname\ || "username:s:yourdomainname\"
 +
|-
 +
| ''Allow me to save credentials'' || Checked ☑ || "prompt for credentials:i:0"
 +
|-
 +
| ''Display size'' || Full Screen || "screen mode id:i:2"
 +
|-
 +
| ''Display the connection bar when I use the full screen'' || Unchecked ☐ || "displayconnectionbar:i:0"
 +
|-
 +
| ''Use my RD Gateway credentials for the remote computer'' || Checked ☑ || "promptcredentialonce:i:1"
 +
|-
 +
| ''If server authentification fails'' || Connect and don't warn me || "authentication level:i:0"
 +
|}
 +
Replace "yourdomainname" with the actual domain name of the remote computer.<br>
  
−
You can format the "SupportText" text as you like, use ''\n'' for a new rule, ''%hostname%'' for the computer name, ''%ip%'' for the IP-address and ''%mac%'' for the MAC-address.<br>
+
==Setup==
−
When the "Support" text is empty, the support button will not be displayed.
 

Latest revision as of 02:10, 1 May 2025

About

OpenTC Login.png

OpenTC is login portal for Remote Desktop Connections on Windows, it replaces the default shell and explorer.
It provides end-users with a closed environment, and prevents them from accessing features outside the Remote Desktop connection.
This project has been setup as a free and open-source alternative to professionalize using Thin Clients.

OpenTC Development

Features

  • Provide a closed environment for the user dedicated to connect to one or multiple Remote Desktop farms or server.
  • Prevents users from accessing the local desktop, start menu, and other Windows features.
  • Add Remote Desktop environments for the user to choose from, by simply uploading .rdp files to the client.
  • A support button provides users with useful information, like how to contact local support and computer specifications.
  • Background image and logo are easily changable.
  • Dynamically and easily be able to change settings, images, and language.
  • The client can be remote controlled (shadowed) by administrators for support or administrative purposes.
  • Administrators can still access the default desktop when needed.
  • Lightweight (0% CPU, 10mb memory, 50kb storage).
  • Free and open-source

Requirements

  • Windows 7 or higher
  • .NET Framework 2.0
  • PowerShell 5.1 (for setup script)

Downloads

OpenTC v1.0:
OpenTC v1.0 Source Code:

Settings

The settings are stored in the registry under the key "HKEY_LOCAL_MACHINE\SOFTWARE\OpenTC".

Setting Description Value
Background Path to the background image e.g. "C:\Background.jpg"
Logo Path to the logo image e.g. "C:\Logo.jpg"
Language Path to the language file e.g. "C:\English.txt"
RDP Path to the folder with the .rdp file(s) e.g. "C:\RDP\"
Power Power button behaviour "Disabled", "Shutdown", or "Restart"

When using no full directory path, it will automatically look for the file or folder in the same directory as the executable.

Images

The background image will be shown on all monitors, and will be automatically stretched to fit the screen.
The logo image must be provided in 400x100 resolution.

Language

All translations of text and buttons are located in a text file. Language file 'English.txt' comes included.

Support

The text in the support dialog is changable by editing "HELPTEXT" in the Language file.
You can use these environment variables:

Variable Result
\n A new line
%HOSTNAME% Hostname
%IP% IP
%MAC% MAC

You can hide the support button by changing the "HELP" text translation to be empty.

RDP

The Remote Desktop connections that the user can select from are all the .rdp files from the RDP folder.

Make sure the following settings have been applied for .rdp files:

Setting Value File Value
User name yourdomainname\ "username:s:yourdomainname\"
Allow me to save credentials Checked ☑ "prompt for credentials:i:0"
Display size Full Screen "screen mode id:i:2"
Display the connection bar when I use the full screen Unchecked ☐ "displayconnectionbar:i:0"
Use my RD Gateway credentials for the remote computer Checked ☑ "promptcredentialonce:i:1"
If server authentification fails Connect and don't warn me "authentication level:i:0"

Replace "yourdomainname" with the actual domain name of the remote computer.

Setup

Retrieved from "http://wiki.danit.nl/index.php?title=OpenTC&oldid=209"