====== Synchronet Control Panel Properties ======
The Synchronet Control Panel Properties page is available through the File->Properties menu option.

Most of the values set in this dialog are saved in your Synchronet ''[[config:sbbs.ini]]'' file.

===== Settings =====

{{:monitor:sbbsctrl:sbbsctrl.settings.png?nolink|}}

==== Login Command ====
The //Login Command// is what is invoked when the BBS->Login menu option is used. This is a telnet URI by default, pointing to //localhost// which should start the Windows default handler for Telnet connections, but you could put any command-line here.

If executing the telnet:/// URI doesn't work (you don't have an associated handler installed/enabled in Windows) or is handled by a different terminal program than you prefer, you could install [[resource:term|SyncTERM]] for Windows and change the //Login Command// to:
  syncterm telnet://localhost

==== Config Command ====
The //Config Command// is what is invoked when the BBS->Configure menu option is used. Normally this will be a command to invoke [[util:SCFG]]. 
  * The first ''%s'' will be replaced with the path to the Synchronet ''[[dir:exec]]'' directory.
  * The second ''%s'' will be replaced with the path to the Synchronet ''[[dir:ctrl]]'' directory.

==== Node Display Interval (seconds) ====
This setting controls the frequency of updates to the "Node" window in the Synchronet Control Panel. This setting is only applied when the Node window is visible.

==== Clients Display Interval (seconds) ====
This setting controls the frequency of updates to the "Clients" window in the Synchronet Control Panel. This setting is only applied when the Clients window is visible.

==== Semaphore Check Interval (seconds) ====
This setting controls the frequency at which semaphore files are checked. Lower numbers mean more disk or CPU activity, even while the BBS is idle.


==== Minimize to System Tray ====
When checked, this setting will place a small icon in the Windows "system tray" or "notification area" (usually in the lower right corner of your display) when the Synchronet Control Panel is minimized rather than a normal icon/button on your task bar. The system tray icon is also animated when the BBS is in use.

=== Password ===
When minimized to the system tray, you can optionally require a password to be typed by the local user for the Synchronet Control Panel to be restored/visible. This is a very simple security measure to help prevent un-trusted users of your system from stopping or re-configuring your BBS services (when minimized). An advanced malicious user could easily find other ways to stop or reconfigure the BBS.

===== Security =====

{{:monitor:sbbsctrl:sbbsctrl.security.png?nolink|}}

The settings on this tab control the automatic throttling, logging, and filtering/banning (both permanent and temporary) of clients (IP addresses) that repeatedly try and fail to login to your BBS.

**See How-To: [[howto:block-hackers]] for more details on these settings**.

===== Customize =====

{{:monitor:sbbsctrl:sbbsctrl.customize.png?nolink|}}

The settings on this tab allow the sysop to customize the look of the Synchronet Control Panel windows. Each window can have the following customized:
  * Font Face, Style, Size and Color (for each log level)
  * Background Color

==== Schemes ====
Customized settings for one window can be easily cloned into another window by using the **Apply Scheme To:** button. The **Scheme** text box just shows an example of the current color/font scheme for the selected window. Changing the upper-left window selection resets the current scheme to that of the newly selected window. Changes to that scheme can then be made with the **Change Font** and **Background Color** buttons and then applied to a new window by selecting a target window with the lower-right window selection and clicking the **Apply Scheme To:** button.

===== Advanced =====

{{:monitor:sbbsctrl:sbbsctrl.advanced.png?nolink|}}

==== Control Directory ====
This setting points to your Synchronet ''[[dir:ctrl]]'' directory. The value is normally automatically derived from the ''[[config:env#SBBSCTRL]]'' environment variable, but you can override this value here if you wish.

==== Temp Directory ====
This setting determines where Synchronet will store temporary files. The default is ''[[dir:temp]]'' off of the same parent directory as your ''[[dir:ctrl]]'' directory (i.e. ''../temp'').

==== Hostname ====
The DNS host name of this instance of Synchronet may be over-ridden using this setting. If not set, the value from [[util:SCFG]]->Networks->Internet->Address is used for the system's public host name, where needed.

==== Log Window Size ====
Log windows in the Synchronet Control Panel consume memory (for scroll-back history). To limit this memory consumption, set this value to a specific number of lines (log history) to store in the Window. Logs written to disk are not limited by this setting.

==== Error Sound ====
This setting is used to specify the path to an optional WAV file which will be played on the local/server system every time there is an error condition detected in the system and logged.

==== Undockable Windows ====
Checking this box allows the child windows of the Synchronet Control Panel to be "undocked" from the parent window and floated (e.g. on another monitor).

==== Use File Associations ====
Checking this box causes the Synchronet Control Panel to use Windows' file associations for opening text and configuration files with common file extensions/suffixes (e.g. ''.txt'', ''.cfg'', etc.). When unchecked, a simple text editor built into the Synchronet Control Panel will be used to open and edit these types of files.
===== JavaScript =====

{{:monitor:sbbsctrl:sbbsctrl.javascript.png?nolink|}}

The settings in this tab allow the sysop to change the operating parameters of the JavaScript run-time used in all Synchronet Servers and Services.

===== See Also =====
  * [[:monitor:sbbsctrl|Synchronet Control Panel]]
  * [[:config:sbbs.ini]]

{{tag>properties sbbsctrl}}