Quantcast
Channel: Terminals Wiki & Documentation Rss Feed
Viewing all 125 articles
Browse latest View live

Updated Wiki: User documentation

$
0
0

User documentation

Well, on the beginning it was a small application...
But anyway, don't search here for SSH specification, or how to enable remote desktop for your account on Windows server. Simply we have to expect, that you know, how to use required service. It is out of scope of this documentation to describe, how network protocols work or how to configure them. And because each implementation of the same service may differ, here you can find only informations, how to use and configure Terminals as a service client and what are its specifics.

Key application terms:

  • Connection - session between computer, which offers remote control, and your Terminals application
  • Terminal - text window, which can be used for not GUI remote control protocols like Telnet or SSH
  • Favorite - stored configuration, which allows you to connect to one service on one server using one user login
  • Tag - text associated with one or more favorites, which allows you to group your favorites into logical groups visible in tree.
  • Group - set of favorites used for batch connection operations. Since version 3.0 only Groups and Tags are used in the same meaning
  • Shortcut - stored configuration, which allows you to start script or application directly from Terminals application. By default Terminals comes with shortcuts to Microsoft management console and Control panel applets
  • Capture - stored screen picture of your running connection
  • Protocol - type of remote control service offered by server you want to connect to
  • Credentials - authentication information (Domain, user name and password). Note, that you don't have to store your passwords. For more details check the documentation.

Note: New version 3.0 CTP doesn't distinguish between Tag and group

How to ...


Updated Wiki: Application Options

$
0
0

Application Options

Because application contains large number of options used to configure its behavior and it is not possible to describe the behavior directly in the option, here is list of the options and their explanations. To configure the application options go to "Tools > Options" (Shortcut CtrlShiftP).

NOTE: This page is under construction!
  • Startup & Shutdown
    • Allow a single instance of the application: ...
    • Don't keep me up-to-date on Terminals project: ...
    • Show close confirmation dialog: ...
    • Save connections on close: ...
  • Interface
    • Show user name in tab title: ...
    • Show connection information in tooltips: ...
    • Show full information: ...
    • Minimize to System Tray: ...
    • Enable Groups menu: ...
    • Theme: ...
      • Favorites:
        • Enable Favorites panel: ...
        • Auto expand (show) favorites Panel, when hidden: ...
        • Favorites sorting: ...
  • Security
    • Master password: ...
    • Default password: ...
    • Amazon S3 Service: ...
  • Connections
    • Validate Server names: ...
    • Show confirm dialog on Close or warn or disconnect: ...
    • Ask to reconnect when connection is lost due Shutdown or reboot: ...
    • Automatically restore the main window when the last connection is closed: ...

...

Updated Wiki: Backup and restore settings files

$
0
0

How to backup and restore settings files

Like other applications Terminals stores its data in data files on your disk. All these files are stored under application directory except files, where explicit path is mentioned. Following chapters list all files explaining their content and meaning. Terminals doesn't store any data in Windows registry, so you only have to backup the application directory. This also allows use Terminals as portable application, but require run it under elevated privileges on Windows Vista and later OS version.
Any changes are immediately confirmed into the files. Passwords saved in all files are always written in encrypted form.
To reset configuration or restore to previous state simply close Terminals and replace or remove required file.

It is strongly recommended, that you backup these files before you upgrade to new version.

Data files

When discussing application data, we are talking about values, you create using Terminals like Favorites, Credentials, Tags and history.
  • History.xml - Stores content visible in History pane. This content is updated whenever you connect to some favorite. Removing this file will clear the history.
  • Credentials.xml - contains values of stored credentials.
  • Terminals.config - This is the main Terminals data file. Here Tags, Favorites and application application options are saved. Removing this will clear all your favorites and next time you start terminals, first run wizard will appear.

Window layout files

Layout files hold only positions of main window and tool bars. When you encounter any problem with window position or tool bars, you can remove this files to reset the window layout.
  • ToolStrip.settings.config - Main window tool bar positions
  • user.config - Not used since version 3.0. Was stored in user profile (usually in "c:\Documents and Settings\<username>\Local Settings\Application Data\RobertChartier\<Terminals>\<Version>\"). Contains main window position and size.

Log files

  • Terminals.log4net.config - logging configuration. No one usually changes content of this file.
  • currentlog.txt - located "Logs" subdirectory in application folder. All problems are noticed in this files. If you want to report any issue, please provide this file as attachment.
  • LastUpdateCheck.txt - holds only date of last update. This file isn't used yet.

Version 3.0:

  • Has different files structure depending on installation type, which is described in Upgrade to version 3.0*
  • All user files of the application are stored in one "Data" directory. This make the application 100% portable.
  • All other rules are still valid except:
    • Content of the files is not backward compatible with version 2.0 and older
    • Stronger encryption is used and also additional fields in data files are encrypted (Domain and user name wasn't encrypted till version 3.0)
    • New file was added: Favorites.xml - contains all groups and their favorites. This version no longer stored favorites and their groups (Tags) in config file.
    • User.config file is not used. Currently window positions were moved to the Terminals.config

Updated Wiki: Application Options

$
0
0

Application Options

Because application contains large number of options used to configure its behavior and it is not possible to describe the behavior directly in the option, here is list of the options and their explanations. To configure the application options go to "Tools > Options" (Shortcut Ctrl+Shift+P).

NOTE: This page is under construction!
  • Startup & Shutdown
    • Allow a single instance of the application: ...
    • Don't keep me up-to-date on Terminals project: ...
    • Show close confirmation dialog: ...
    • Save connections on close: ...
  • Interface
    • Show user name in tab title: ...
    • Show connection information in tooltips: ...
    • Show full information: ...
    • Minimize to System Tray: ...
    • Enable Groups menu: ...
    • Theme: ...
      • Favorites:
        • Enable Favorites panel: ...
        • Auto expand (show) favorites Panel, when hidden: ...
        • Favorites sorting: ...
  • Security
    • Master password: ...
    • Default password: ...
    • Amazon S3 Service: ...
  • Connections
    • Validate Server names: When editing favorite, the "Server Name" field is validate to be valid computer name or IP address. If not valid you can't save the favorite
    • Show confirm dialog on Close or warn or disconnect: If connection is lost or you are closing the connection, you are prompted, if you want to close the connection. This allows you to be informed, that the connection is lost. If not enabled and connection is lost opened connection is closed without warning (except RDP, see next option)
    • Ask to reconnect when connection is lost due Shutdown or reboot: This option applies to RDP only and replaces previous option if enabled. If connection is lost a reconnecting dialog is shown and you are able to manually ask to be reconnected (when machine is available again) or close the connection. This options is helpful in a case you or someone else is restarting the server and you want to be reconnected later. Terminals tries to reconnect one hour, if server is not available, the connection is closed.
    • Automatically restore the main window when the last connection is closed: Helpful, if you are using Terminals minimized to system tray and you want to continue in the app with another connection or favorite
    • Default Desktop Share
    • Port scanner timeout: Number in seconds, the maximum time the networking tool "Port scanner" will try to check opened port on target machine. Range 0 - 60, default value is 5.
      • Execute before connect: This options allow you to execute some application (or script) each time you open new connection. Applies to all connections and the configured command starts on your computer locally.
      • Proxy:
  • Screen capture (How to use screen capture)
    • Enable screen capture to clipboard: When you press button to capture screen the screen shot is stored into the Windows clipboard
    • Enable screen capture to folder: Like the previous option, but the picture is saved to the directory, configured as Screen capture root folder.
    • Auto switch to Capture manager on capture: After taking a screen capture, Capture manager tool is automatically opened.
    • Screen capture root folder: Folder used to store captured pictures and is shown as root folder when opening Capture manager.
      • Flicker: Online service which allows to synchronize and publish your pictures online. Authorize first and then you can access your service.

Updated Wiki: Application Options

$
0
0

Application Options

Because application contains large number of options used to configure its behavior and it is not possible to describe the behavior directly in the option, here is list of the options and their explanations. To configure the application options go to "Tools > Options" (Shortcut Ctrl+Shift+P).

NOTE: This page is under construction!
  • Startup & Shutdown
    • Allow a single instance of the application: ...
    • Don't keep me up-to-date on Terminals project: ...
    • Show close confirmation dialog: ...
    • Save connections on close: ...
  • Interface
    • Show user name in tab title: ...
    • Show connection information in tooltips: ...
    • Show full information: ...
    • Minimize to System Tray: ...
    • Enable Groups menu: ...
    • Theme: ...
      • Favorites:
        • Enable Favorites panel: ...
        • Auto expand (show) favorites Panel, when hidden: ...
        • Favorites sorting: ...
  • Security
    • Master password: ...
    • Default password: ...
    • Amazon S3 Service: ...
  • Connections
    • Validate Server names: When editing favorite, the "Server Name" field is validate to be valid computer name or IP address. If not valid you can't save the favorite
    • Show confirm dialog on Close or warn or disconnect: If connection is lost or you are closing the connection, you are prompted, if you want to close the connection. This allows you to be informed, that the connection is lost. If not enabled and connection is lost opened connection is closed without warning (except RDP, see next option)
    • Ask to reconnect when connection is lost due Shutdown or reboot: This option applies to RDP only and replaces previous option if enabled. If connection is lost a reconnecting dialog is shown and you are able to manually ask to be reconnected (when machine is available again) or close the connection. This options is helpful in a case you or someone else is restarting the server and you want to be reconnected later. Terminals tries to reconnect one hour, if server is not available, the connection is closed.
    • Automatically restore the main window when the last connection is closed: Helpful, if you are using Terminals minimized to system tray and you want to continue in the app with another connection or favorite
    • Default Desktop Share
    • Port scanner timeout: Number in seconds, the maximum time the networking tool "Port scanner" will try to check opened port on target machine. Range 0 - 60, default value is 5.
      • Execute before connect: This options allow you to execute some application (or script) each time you open new connection. Applies to all connections and the configured command starts on your computer locally.
      • Proxy: Applies only to Download manger to inform you about latest releases. If not defined, the application will use the system proxy defined for your browsers. Currently doesn't apply to the HTTP or HTTPS favorites.
  • Screen capture (How to use screen capture)
    • Enable screen capture to clipboard: When you press button to capture screen the screen shot is stored into the Windows clipboard.
    • Enable screen capture to folder: Like the previous option, but the picture is saved to the directory, configured as Screen capture root folder.
    • Auto switch to Capture manager on capture: After taking a screen capture, Capture manager tool is automatically opened.
    • Screen capture root folder: Folder used to store captured pictures and is shown as root folder when opening Capture manager. By default the capture manager points to "Terminals Captures" in your "Pictures" directory.
      • Flicker: Online service which allows to synchronize and publish your pictures online. Authorize first and then you can access your service.

Updated Wiki: Application Options

$
0
0

Application Options

Because application contains large number of options used to configure its behavior and it is not possible to describe the behavior directly in the option, here is list of the options and their explanations. To configure the application options go to "Tools > Options" (Shortcut Ctrl+Shift+P).

NOTE: This page is under construction!

Startup & Shutdown

  • Allow a single instance of the application: ...
  • Don't keep me up-to-date on Terminals project: ...
  • Show close confirmation dialog: ...
  • Save connections on close: ...

Interface

  • Show user name in tab title: If enabled, Not only the connection name, but also the user information will be shown in connection tab title
  • Show connection information in tooltips: If enabled, favorite detail information (server address, port, protocol and user name) tool tip will be shown when mouse over the favorites tree or connection tab. Also when selecting connection its information is shown in application main window title.
  • Show full information: Like previous option, but tool tip will contain more detailed information (Groups, Notes)
  • Minimize to System Tray: If enabled, click on the application icon in the Windows task bar, Terminals will minimize (disappear) from the task bar and only its icon will be available in system tray.
  • Enable Groups menu: When disabled, removes "Groups" menu from the main window main menu.
  • Theme: Defines color of the tool bars and application main menu. Choose Normal to define usual color.
  • Favorites:
    • Enable Favorites panel: When disabled favorites panel (Favorites tree and History) is removed from main window
    • Auto expand (show) favorites Panel, when hidden: Favorites panel is automatically expanded whe mouse is over its collapse/expand handle.
    • Favorites sorting: Used to sort favorites in favorites tree and all menus, where favorites are listed

Security

  • Master password: You can change the application master password. This password is used to protect all passwords you store in the app. Even if not defined, your passwords are not readable to others, but are weak to be hacked. You may be prompt to provide it during application upgrades. NOTE: Requires application restart.
  • Default password: Credentials to be used only when opening new connection and no credentials are provided by the favorite.
  • Amazon S3 Service: Synchronize your Terminals.config file only to the Cloud provided by Amazon S3 service. Use "Backup" button to upload the file or "Restore" button to replace your current file by the service store.

Connections

  • Validate Server names: When editing favorite, the "Server Name" field is validate to be valid computer name or IP address. If not valid you can't save the favorite
  • Show confirm dialog on Close or warn or disconnect: If connection is lost or you are closing the connection, you are prompted, if you want to close the connection. This allows you to be informed, that the connection is lost. If not enabled and connection is lost opened connection is closed without warning (except RDP, see next option)
  • Ask to reconnect when connection is lost due Shutdown or reboot: This option applies to RDP only and replaces previous option if enabled. If connection is lost a reconnecting dialog is shown and you are able to manually ask to be reconnected (when machine is available again) or close the connection. This options is helpful in a case you or someone else is restarting the server and you want to be reconnected later. Terminals tries to reconnect one hour, if server is not available, the connection is closed.
  • Automatically restore the main window when the last connection is closed: Helpful, if you are using Terminals minimized to system tray and you want to continue in the app with another connection or favorite
  • Default Desktop Share
  • Port scanner timeout: Number in seconds, the maximum time the networking tool "Port scanner" will try to check opened port on target machine. Range 0 - 60, default value is 5.
  • Execute before connect: This options allow you to execute some application (or script) each time you open new connection. Applies to all connections and the configured command starts on your computer locally.
  • Proxy: Applies only to Download manger to inform you about latest releases. If not defined, the application will use the system proxy defined for your browsers. Currently doesn't apply to the HTTP or HTTPS favorites.

Screen capture

See also: (How to use screen capture)
  • Enable screen capture to clipboard: When you press button to capture screen the screen shot is stored into the Windows clipboard.
  • Enable screen capture to folder: Like the previous option, but the picture is saved to the directory, configured as Screen capture root folder.
  • Auto switch to Capture manager on capture: After taking a screen capture, Capture manager tool is automatically opened.
  • Screen capture root folder: Folder used to store captured pictures and is shown as root folder when opening Capture manager. By default the capture manager points to "Terminals Captures" in your "Pictures" directory.
  • Flicker: Online service which allows to synchronize and publish your pictures online. Authorize first and then you can access your service.

Data Store

NOTE: Requires application restart.

Updated Wiki: Application Options

$
0
0

Application Options

Because application contains large number of options used to configure its behavior and it is not possible to describe the behavior directly in the option, here is list of the options and their explanations. To configure the application options go to "Tools > Options" (Shortcut Ctrl+Shift+P).

NOTE: This page is under construction!

Startup & Shutdown

  • Allow a single instance of the application: When starting Terminals it is checked, if the application is running. If running, the command line arguments are executed on the running instance. If disabled, you are able to start more than one instance of Terminals.
  • Don't keep me up-to-date on Terminals project: If enabled, shows information about new releases during application start up.
  • Show close confirmation dialog: When closing Terminals main window, you will be prompted, if you want to do so.
  • Save connections on close: If enabled and you are closing the application, you can store list of opened connections and Terminals will try to restore them after you start the app again.

Interface

  • Show user name in tab title: If enabled, Not only the connection name, but also the user information will be shown in connection tab title
  • Show connection information in tooltips: If enabled, favorite detail information (server address, port, protocol and user name) tool tip will be shown when mouse over the favorites tree or connection tab. Also when selecting connection its information is shown in application main window title.
  • Show full information: Like previous option, but tool tip will contain more detailed information (Groups, Notes)
  • Minimize to System Tray: If enabled, click on the application icon in the Windows task bar, Terminals will minimize (disappear) from the task bar and only its icon will be available in system tray.
  • Enable Groups menu: When disabled, removes "Groups" menu from the main window main menu.
  • Theme: Defines color of the tool bars and application main menu. Choose Normal to define usual color.
  • Favorites:
    • Enable Favorites panel: When disabled favorites panel (Favorites tree and History) is removed from main window
    • Auto expand (show) favorites Panel, when hidden: Favorites panel is automatically expanded whe mouse is over its collapse/expand handle.
    • Favorites sorting: Used to sort favorites in favorites tree and all menus, where favorites are listed

Security

  • Master password: You can change the application master password. This password is used to protect all passwords you store in the app. Even if not defined, your passwords are not readable to others, but are weak to be hacked. You may be prompt to provide it during application upgrades. NOTE: Requires application restart.
  • Default password: Credentials to be used only when opening new connection and no credentials are provided by the favorite.
  • Amazon S3 Service: Synchronize your Terminals.config file only to the Cloud provided by Amazon S3 service. Use "Backup" button to upload the file or "Restore" button to replace your current file by the service store.

Connections

  • Validate Server names: When editing favorite, the "Server Name" field is validate to be valid computer name or IP address. If not valid you can't save the favorite
  • Show confirm dialog on Close or warn or disconnect: If connection is lost or you are closing the connection, you are prompted, if you want to close the connection. This allows you to be informed, that the connection is lost. If not enabled and connection is lost opened connection is closed without warning (except RDP, see next option)
  • Ask to reconnect when connection is lost due Shutdown or reboot: This option applies to RDP only and replaces previous option if enabled. If connection is lost a reconnecting dialog is shown and you are able to manually ask to be reconnected (when machine is available again) or close the connection. This options is helpful in a case you or someone else is restarting the server and you want to be reconnected later. Terminals tries to reconnect one hour, if server is not available, the connection is closed.
  • Automatically restore the main window when the last connection is closed: Helpful, if you are using Terminals minimized to system tray and you want to continue in the app with another connection or favorite
  • Default Desktop Share
  • Port scanner timeout: Number in seconds, the maximum time the networking tool "Port scanner" will try to check opened port on target machine. Range 0 - 60, default value is 5.
  • Execute before connect: This options allow you to execute some application (or script) each time you open new connection. Applies to all connections and the configured command starts on your computer locally.
  • Proxy: Applies only to Download manger to inform you about latest releases. If not defined, the application will use the system proxy defined for your browsers. Currently doesn't apply to the HTTP or HTTPS favorites.

Screen capture

See also: (How to use screen capture)
  • Enable screen capture to clipboard: When you press button to capture screen the screen shot is stored into the Windows clipboard.
  • Enable screen capture to folder: Like the previous option, but the picture is saved to the directory, configured as Screen capture root folder.
  • Auto switch to Capture manager on capture: After taking a screen capture, Capture manager tool is automatically opened.
  • Screen capture root folder: Folder used to store captured pictures and is shown as root folder when opening Capture manager. By default the capture manager points to "Terminals Captures" in your "Pictures" directory.
  • Flicker: Online service which allows to synchronize and publish your pictures online. Authorize first and then you can access your service.

Data Store

NOTE: Requires application restart.

Updated Wiki: Home

$
0
0
Terminals is a secure, multi tab terminal services/remote desktop client. It uses Terminal Services ActiveX Client (mstscax.dll).

The project started from the need of controlling multiple connections simultaneously. It is a complete replacement for the mstsc.exe (Terminal Services) client.


Support The Project:

      and     


Supported server protocols:

  • Windows remote desktop (RDP)
  • VNC
  • VMRC
  • SSH
  • Telnet
  • RAS
  • ICA Citrix
  • HTTP and HTTPs based viewers 

 See features list

News

August 7, 2013 - Version 3.2 release published
After not successfull previous version here is a fix. Download and test our new version here

July 16, 2013 - Version 3.1 release published

Jun 26, 2013 - Version 3.0 release published

April 29, 2013 - Version 3.0 Public community technical preview 2 release published

April 15, 2013 - Version 3.0 Public community technical preview release published

October 13, 2012 - Visits milestone reached
Congratulations, our project reached first time in history 100k page views/month and about 80k visits/month (statistics).
Thank you for your support.

March 9, 2012 - Community technical preview version 2.1
The sources were updated to fit the new structure for next version. For more infos seeComming soon
 
March 7, 2012 - Version 2.0 Release Available
After long time we decided to publish final release of current state.. It was long run to improve as much as possible.Download Now
 

History

Our Blogs




    New Comment on "Organize favorites"

    $
    0
    0
    could you please add the feature to sort groups

    Updated Wiki: User documentation

    $
    0
    0

    User documentation

    Well, on the beginning it was a small application...
    But anyway, don't search here for SSH specification, or how to enable remote desktop for your account on Windows server. Simply we have to expect, that you know, how to use required service. It is out of scope of this documentation to describe, how network protocols work or how to configure them. And because each implementation of the same service may differ, here you can find only informations, how to use and configure Terminals as a service client and what are its specifics.

    Key application terms:

    • Connection - session between computer, which offers remote control, and your Terminals application
    • Terminal - text window, which can be used for not GUI remote control protocols like Telnet or SSH
    • Favorite - stored configuration, which allows you to connect to one service on one server using one user login
    • Tag - text associated with one or more favorites, which allows you to group your favorites into logical groups visible in tree.
    • Group - set of favorites used for batch connection operations. Since version 3.0 only Groups and Tags are used in the same meaning
    • Shortcut - stored configuration, which allows you to start script or application directly from Terminals application. By default Terminals comes with shortcuts to Microsoft management console and Control panel applets
    • Capture - stored screen picture of your running connection
    • Protocol - type of remote control service offered by server you want to connect to
    • Credentials - authentication information (Domain, user name and password). Note, that you don't have to store your passwords. For more details check the documentation.

    Note: New version 3.0 CTP doesn't distinguish between Tag and group

    How to ...

    Updated Wiki: Advanced usage

    $
    0
    0

    Advanced usage

    Here are some tips, how to use Terminals which cant be directly clean to users.
    • Share favorites file: If you can't use SQL database (which is recommended scenarion) and you want to share your connections, you can share your favorites file directly using command line argument. More about command line arguments see Command line arguments
    • Connect to Virtual private network before starting remote connection: For this purpose you can use "Excecute before connect". This options are available for all connection types.
    • Connect to Windos Azure: Go to favorite RDP options > Extended Settings and fill "Load balanced info" field using following example: <RoleName>#<RoleInstanceName>

    Where: "RoleName" and "RoleInstanceName" (without brackets) should be replaced by your values.
    More Info: http://msdn.microsoft.com/en-us/library/windowsazure/gg433063.aspx

    Updated Wiki: Advanced usage

    $
    0
    0

    Advanced usage

    Here are some tips, how to use Terminals which cant be directly clean to users.
    • Share favorites file: If you can't use SQL database (which is recommended scenario) and you want to share your connections, you can share your favorites file directly using command line argument. More about command line arguments see Command line arguments
    • Connect to Virtual private network (VPN) before starting remote connection: For this purpose you can use "Execute before connect" options. This options are available for all connection types. Go to favorite "Execute" tab page and "Execute before connect" check box. In next three fields fill command line to execute (or path to script) like you do from command prompt.
    • Connect to Windwos Azure: Go to favorite RDP options > Extended Settings and fill "Load balanced info" field using following example: <RoleName>#<RoleInstanceName>

    Where: "RoleName" and "RoleInstanceName" (without brackets) should be replaced by your values.
    More Info: http://msdn.microsoft.com/en-us/library/windowsazure/gg433063.aspx

    Updated Wiki: Home

    $
    0
    0
    Terminals is a secure, multi tab terminal services/remote desktop client. It uses Terminal Services ActiveX Client (mstscax.dll).

    The project started from the need of controlling multiple connections simultaneously. It is a complete replacement for the mstsc.exe (Terminal Services) client.


    Support The Project:

          and     


    Supported server protocols:

    • Windows remote desktop (RDP)
    • VNC
    • VMRC
    • SSH
    • Telnet
    • RAS
    • ICA Citrix
    • HTTP and HTTPs based viewers 

     See features list

    News

    August 22, 2013 - Version 3.3 release published
    Download and test our new version here

    August 7, 2013 - Version 3.2 release published
    After not successful previous version here is a fix.

    July 16, 2013 - Version 3.1 release published

    Jun 26, 2013 - Version 3.0 release published

    April 29, 2013 - Version 3.0 Public community technical preview 2 release published

    April 15, 2013 - Version 3.0 Public community technical preview release published

    October 13, 2012 - Visits milestone reached
    Congratulations, our project reached first time in history 100k page views/month and about 80k visits/month (statistics).
    Thank you for your support.

    March 9, 2012 - Community technical preview version 2.1
    The sources were updated to fit the new structure for next version. For more infos seeComming soon
     
    March 7, 2012 - Version 2.0 Release Available
    After long time we decided to publish final release of current state.. It was long run to improve as much as possible.Download Now
     

    History

    Our Blogs



      Updated Wiki: Developer guide

      $
      0
      0

      Developer guide

      Continuous integration

      • There is a public Team City server configured for our project
      • Use Login as Guest on Login page
      • These builds shouldn't be used as public available development builds (beta or RC)

      Last Successful builds:

      Application life cycle

      • To publish release version:
        • the application version should be updated in Setup project and in Common.AsssemblyInfo.cs
        • Update related build version in Team City nightly builds
        • Keep in mind, that there is new version detected by published release on CodePlex and compared with the build date of the application => Pulish date has to older or equals to the build date.
        • Mark release with label. If you want to rollback to previous version load selected version release label
      • TFS Tasks have iteration path "Terminals" until there is at least one related checkin. Then change the iteration path to the current development version
      • When fixing an issue, mark it as Fixed (not as Closed). Task is closed as a part of release, if there are no comments otherwise it is shifted to next version.

      Cooperation rules

      • Miguel de Icaza has a good post on Open Source Contribution Etiquette that is worth reading, as the guidance he gives applies well to Terminals (inspired by Nuget project).
      • Pickup from task stack by Votings
      • Select only task, which you are able to solve in no more than two months
      • Don't keep your checkouts long time, use Shelve sets instead
      • Always associate check-in change set with task, if your check in is related to it
      • In case of formating make two separate checkins: one which holds only code formating changes, second with fix/feature changes

      Project structure

      • Current development tool is Visual Studio 2010 with .NET C#.
      • The main solution project is configured to target .NET framework 4. But there are other external projects, which are still targeting .NET 2.0. Don't change the target framework for them.
      • For Logging the Log4Net is configured. Log files are stored under application Logs subdirectory.
      • To build the release setup use the "Distribution release" solution configuration. For general development use standard debug and release.
      • Output directory is default directory under the Terminals project.
      • Put all localize able resources under the Localization directory in resource file stored there.
      • The latest development branch is stored under "Main\Sources"
      • To create user branch create your own under "FeatureBranches" directory and branch allways whole main subtree
      • All extrenal components and other resources like images should be stored under "Resources" directory in its branch
      • Temporar solution for new setup created in WIX is present in the sources directory and will be removed after the setup is able to replace current setup

      External components

      Coding rules

      • Use Visual Studio 2010 default settings or similar settings in another editor.
      • For developer who are using Resharper, there is a Team shared configuration file for coding rules. Don't change this file, if you want to apply some rules. Discuss it first within the team.
      • Indents are 4 spaces. You can use Productivity Power Tools for VS to convert tab characters into spaces.
      • Fields should be declared private and above all methods.
      • Put curly brackets on a new line and close it in the same indentation.
      • Keep classes small up to maximum 500 lines
      • Keep methods small up to maximum 35 lines
      • Use usings as much as possible and remove not used usings
      • When using an if condition with one statement, put the statement on the next line.
      if (true)
             DoSomething();
      
      • When using an if condition with one statement after if condition and else condition, curly brackets are optional.
      if(true)
             DoSomething();
         else
             DoSomethingElse();
      
      • When using an if condition with curly brackets, use curly brackets for all attached conditions
      if (true)
         {
             x++;
             DoSomething();
         }
         else
         {
             DoSomethingElse();
         }
      
      • After an if, while, for each or other conditions that can use curly brackets, leave an empty line.
      if (true)
            DoSomething();
      
         x++;
         foreach(String s in stringArray)
         {
            Debug.Print(s);
         }
         
         DoTheNextThing();
      
      
      • Use String.Format when possible.
      • Use String.Empty instead of "", use String.IsNullOrEmpty() instead of (x == null | x = "").

      Updated Wiki: Home

      $
      0
      0
      Terminals is a secure, multi tab terminal services/remote desktop client. It uses Terminal Services ActiveX Client (mstscax.dll).

      The project started from the need of controlling multiple connections simultaneously. It is a complete replacement for the mstsc.exe (Terminal Services) client.


      Support The Project:

            and     


      Supported server protocols:

      • Windows remote desktop (RDP)
      • VNC
      • VMRC
      • SSH
      • Telnet
      • RAS
      • ICA Citrix
      • HTTP and HTTPs based viewers 

       See features list

      News

      September 20, 2013 - Downloads milestone reached
      Congratulations, during this Summer, you have downloaded 25k files in two months on project web site.
      Thank you for your support. 

      August 22, 2013 - Version 3.3 release published
      Download and test our new version here

      August 7, 2013 - Version 3.2 release published
      After not successful previous version here is a fix.

      July 16, 2013 - Version 3.1 release published

      Jun 26, 2013 - Version 3.0 release published

      April 29, 2013 - Version 3.0 Public community technical preview 2 release published

      April 15, 2013 - Version 3.0 Public community technical preview release published

      October 13, 2012 - Visits milestone reached
      Congratulations, our project reached first time in history 100k page views/month and about 80k visits/month (statistics).
      Thank you for your support.

      March 9, 2012 - Community technical preview version 2.1
      The sources were updated to fit the new structure for next version. For more infos seeComming soon
       
      March 7, 2012 - Version 2.0 Release Available
      After long time we decided to publish final release of current state.. It was long run to improve as much as possible.Download Now
       

      History

      Our Blogs




        Updated Wiki: Organize favorites

        $
        0
        0

        How to organize favorites

        Some of you are connecting to many computers. Searching for required favorite than doesn't have to be easy. In main window, Favorites pane shows only connection name and you are able only create new connection or edit existing. To provide more comfortable favorites management go to "Favorites" > "Organize favorites". In this dialog you see more information at once and additionally you can Delete, Copy, Rename or import existing connections.

        Manage Groups (Tags)

        When managing discussions on the internet we are used to organize our topics using labels called Tags. In Terminals this labels are also called Tags and are used in similar meaning. There is no extra tool, where you organize Tags for all connections. Simply open one selected connection settings and switch to "Groups" page. Here you will see three boxes:
        • "New Group": If you need create new Groups, type its name here and click on green button close to it. New Tag will be listed in available
        • "Connection Group": Here are listed all Groups associated to this connection. Button on right side removes selected Tag from this list. To add new Tags use text box above or select existing one from text box bellow.
        • "All available Group": Lists all Tags defined on all connections. If you want to show more connections under the same Tag, select one from this list and click green button on right side or double click on it.

        Import favorites

        When reinstalling or moving from one computer to another or moving from another tool (;-)) you will probably need to backup, restore, import and export favorites. You can do this from main window "File" menu or from "Organize favorites".
        Supported file formats are:

        ApplicationFile extensionImportExport
        TerminalsXMLXX
        Microsoft remote desktopRDPXX
        Multiple remote desktops managerMRCX-
        Visionapp remote desktopVRBX-


        Immediately after first time Terminals starts, you will be prompted, if you want to import RDP connections from Windows registry.
        There are stored recently used Microsoft remote desktop connections, so don't have to import them manually.

        To export favorites you have to select, which favorites you want to export. By default passwords aren't exported. Because of internal algorithms, the only supported format from where you can import passwords is Terminals file. Please note that if you select "Export passwords", passwords will be exported in human readable form into the target file!
        When importing connections, you can choose, if you want to overwrite existing connections with the same name. Therefore we recommend to back up your connections before you import from unknown file.

        Favorites tree

        All operations to create connection favorites can be done in Favorites tree. The tree allows all operations you usually in Windows Explorer (add group, delete favorite etc.). You can also use drag and drop. Here are tips how to use it:
        • You can also import connections using drag and drop of files into favorites tree
        • Hold "Control" key during drag drop to Copy dragged favorite
        • Hold "Shift" key during drag drop to Add favorite to target group

        Search for computers servicing remote control protocol

        In large networks or if you don't know server name, it is comfortable to search for computers in the network automatically. In terminals you have extra options to do so, not only to import connections from a file. All choices are available in "Organize Favorites" dialog mentioned in previous chapter.
        • Scan Active Directory: If your computer is member of Microsoft Active Directory, you can search the active directory for computer entries. Later you can select computers in results list and create favorites for them.
        • Scan Network using port scanner: This feature offers you to scan all IP addresses in required range for known services. By default your IP address range is selected and all services used by Terminals are searched.
        • Direct connect to other Terminals

        Active directory scan:

        Terminals._ADSearch.png

        Domain: Domain name to search in. Doesn't have to be fully qualified domain name. Default domain defined Terminals Options is used as default value.
        Max. results: Maximum results to obtain. Number in range 0-5000, default 1000. Used to reduce number of obtained results.
        Search root: In case of large domain you can define start point of the search. Usually AD organization unit. For the ou 'servers' under the root of the domain 'mydomain.local', you have to fill in ou=servers,dc=mydomain,dc=local' to start searching from there. Leave empty to search in whole domain (default).
        LDAP filter: LDAP search filter to use. Use default value to obtain all computers only. For more details how to filter see http://social.technet.microsoft.com/wiki/contents/articles/5392.active-directory-ldap-syntax-filters.aspx
        Refresh button: Set search criteria (domain, search root, filter and max. results) to default values.

        Note: Some properties are available since version 3.0.

        On second page "Direct connection" in "Scan Network" dialog you can establish a direct connection with another machine on the network in order to share connections. In this case the server application and the client application is Terminals running on both sides. Follow the steps described in this dialog.

        Grouping connections

        Some people are working simultaneously on more than one remote computer. In this case you will need to group favorites and start all connections in one group at once. First you have to create groups. You can do so by selecting "Create group from active connections" from "Groups menu". This command opens dialog, where you type group name and all active connections will be added to the newly created group. Or you can select "Add current connection to" command, if you want to add the active connection to already created group. To use more custom groups management, open "Organize groups" from the same menu. The opened dialog will present two tables. In the left side you define groups and on the right side you select connections associated with selected group. Each table has its own two buttons to Add/Remove items.

        New Comment on "Store data in SQL database"

        $
        0
        0
        I would love to use this feature, what are the chances that different users can have a different set of credentials?

        Updated Wiki: Home

        $
        0
        0
        Terminals is a secure, multi tab terminal services/remote desktop client. It uses Terminal Services ActiveX Client (mstscax.dll).

        The project started from the need of controlling multiple connections simultaneously. It is a complete replacement for the mstsc.exe (Terminal Services) client.


        Support The Project:

              and     


        Supported server protocols:

        • Windows remote desktop (RDP)
        • VNC
        • VMRC
        • SSH
        • Telnet
        • RAS
        • ICA Citrix
        • HTTP and HTTPs based viewers 

         See features list

        News

        December 10, 2013 - Version 3.4 release published
        Download and test our new version here

        September 20, 2013 - Downloads milestone reached
        Congratulations, during this Summer, you have downloaded 25k files in two months on project web site.
        Thank you for your support. 

        August 22, 2013 - Version 3.3 release published
        Download and test our new version here

        August 7, 2013 - Version 3.2 release published
        After not successful previous version here is a fix.

        July 16, 2013 - Version 3.1 release published

        Jun 26, 2013 - Version 3.0 release published

        April 29, 2013 - Version 3.0 Public community technical preview 2 release published

        April 15, 2013 - Version 3.0 Public community technical preview release published

        October 13, 2012 - Visits milestone reached
        Congratulations, our project reached first time in history 100k page views/month and about 80k visits/month (statistics).
        Thank you for your support.

        March 9, 2012 - Community technical preview version 2.1
        The sources were updated to fit the new structure for next version. For more infos seeComming soon
         
        March 7, 2012 - Version 2.0 Release Available
        After long time we decided to publish final release of current state.. It was long run to improve as much as possible.Download Now
         

        History

        Our Blogs



        Updated Wiki: Welcome To Terminals

        $
        0
        0

        Whats new with Terminals?

        Keep this project alive, Donate!

        October 13, 2012 - Visits milestone reached
        Congratulations, our project reached first time in history 100k page views/month and about 80k visits/month (statistics).
        Thank you for your support.

        March 9, 2012 - Community technical preview version 2.1
        The sources were updated to fit the new structure for next version.

        March 7, 2012 - Version 2.0 Release Available
        After long time we decided to publish final release of current state.. It was long run to improve as much as possible.

        November 24, 2011 - Version 2, Beta 4 Available
        We just pushed up Beta 4 for Version 2. Take time to upgrade and let us know what you think.

        November 10, 2011 - Automatic Buids
        Friends of ours have graciously allowed us to piggy back on their TeamCity installation, which allows us to start publishing frequent builds. In fact we setup TeamCity to produce a build on every code commit! For more info, check the Continuous integration chapter in developer guide in online documentation.

        November 1, 2011 - Beta Release for version 2
        Now that we have made some serious progress through the bug tracker the team has decided that now would be a good time to re-enter the beta/testing stage for a final version 2.0 release. Please take time to download the release and provide feedback ASAP.

        June 26, 2011 - An Update.
        I ran through the Issue Tracker and pushed out all issues to either a 2.0 or 2.1 build. The 2.0 items are items which we are going to try to achieve to get done for an official 2.0 release. If your item is NOT in that list, raise the issue and lets discuss. All items pushed to 2.1 are pushed to a "future" release, be that 2.1 or beyond.
        I also tried to close any long standing, inactive issues which seem dormant and I couldn't easily reproduce. If something was closed in error, just re-open it and we can deal with it accordingly.

        Feb 15, 2011 - (Happy Valentines Day!) Terminals 2.0 Beta 1 released
        Download Now
        This release has been updated for RDP Client 6 support. Please ensure your RDP6 client files are registered correctly when running it. Read the release notes on the download page for a complete list of changes. This DOES include the NLA/RDP6 additions!

        May 11, 2010 - Terminals 1.9a released
        Download Now
        This release has been updated for RDP Client 6 support. Please ensure your RDP6 client files are registered correctly when running it.

        February 17, 2010 - Terminals 1.9 Beta released
        Download Now
        This beta release has been updated for RDP Client 6 and adds some great new functionality so test it out and let us know how it goes.

        January 27, 2010 - Terminals 1.8c
        Download Now
        A new release that fixes some old bugs and adds ability to save defaults.

        November 4, 2009 - Terminals 1.8b - Problematic Interface fixes
        Download Now
        Just a small release that fixes some of the annoying bugs introduced in 1.8a

        October 14, 2009 - Terminals 1.8a - Stable Version Released
        Download Now
        This version has a lot of the bugs that were in 1.7e fixed up now. Enjoy!!

        October 5, 2009 - Terminals 1.8 Beta - Credential Management Released
        Download Now

        January 15, 2009 - Terminals 1.7e - History
        Download
        We now have History in the Favorites Panel!

        January 07, 2009 - Terminals 1.7d - Bugs and upgrades to VNC, SSH
        Download
        This release includes a bunch of defects which have been streaming in via the Issue Tracker and Discussions (keep it up folks!).

        November 07, 2008 - 1.7c House Cleaning
        Download
        This is primarily another bug fix release.

        November 07, 2008 - VOTE: Terminals
        LifeHacker has a Hive Five Call For Contenders - Best Remote Desktop Tools nomination in progress. Be sure to add your vote for Terminals!

        September 09, 2008 - 1.7b Various Bugs
        Download
        This is a bug fix release only. Based on feedback from the community I have decided to cut back the number of new features and focus on performance, and stability.


        September 03, 2008 - 1.7a Amazon S3 Backup+Restore Download
        This is the first release of a simplistic mechanism to backup/restore your configuration files using the Amazon S3 Web Services.


        August 25, 2008 - Terminals 1.7 - Vista + 2008 Support
        This is the first release for Vista and Windows Server 2008 Support. (console vs admin switch).

        It has been tested on Windows XP, Windows Server 2008 (Standard) connecting to Windows Server 2008, 2003 and XP. Console/Admin mode works perfectly.

        General Networking Tools added:
        Ping, Trace Route, WMI Explorer, TCP Connections, Network Interfaces, Whois, DNS Lookups, CPU History Graph, Shares List, Time Syncronization, Packet Capturing, Terminal Services Administration (tsadmin) etc...

        May 11, 2008 - Version 1.6l - Bugs, Multi-Monitor support
        This release brings the bug down to under 30 outstanding issues in total. I also added the ability to detach a terminal window on its own. Very useful when you need more than one window active at any give time, multi-monitor support.

        May 10, 2008 - Keep this project alive, Donate!

        May 5, 2008 - Version 1.6k - More AD, Packet Capture
        This release brings a UI dialog and Favorites Import tool for Active Directory Scanning. The second major feature is the integration with WinPcap. This feature allows you to capture network packets on any given Network device. This includes filtering based on the standard tcpdump rules and capturing directly to a file (c:\Terminals.dump). Read More Here

        April 30, 2008 - Version 1.6j has been release which includes a number of bug fix's and Active Directory support. Download now

        April 30, 2008 - VOTE: Connect to Console Bug : Microsoft decided to not carry forward support connecting to console sessions in the newer versions of the RDP protocol. This effects Windows Server 2008, Vista SP1 and XP SP3 users. Go Rate/Validate now!

        April 30, 2008 - We are now over 55,000 downloads, averaging 100 downloads per day, 120 work items closed.

        October 27, 2007 - We are celebrating 2 events: 10000 downloads of the latest release and we are now number one result in Google's search for the word Terminals. This can change from time to time but it is quite impressive to be the first from 36,300,000 results.

        Updated Wiki: Home

        $
        0
        0
        Terminals is a secure, multi tab terminal services/remote desktop client. It uses Terminal Services ActiveX Client (mstscax.dll).

        The project started from the need of controlling multiple connections simultaneously. It is a complete replacement for the mstsc.exe (Terminal Services) client.


        Support The Project:

              and     


        Supported server protocols:

        • Windows remote desktop (RDP)
        • VNC
        • VMRC
        • SSH
        • Telnet
        • RAS
        • ICA Citrix
        • HTTP and HTTPs based viewers 

         See features list

        News

        December 10, 2013 - Version 3.4 release published
        Download and test our new version here

        September 20, 2013 - Downloads milestone reached
        Congratulations, during this Summer, you have downloaded 25k files in two months on project web site.
        Thank you for your support. 

        August 22, 2013 - Version 3.3 release published
        Download and test our new version here

        August 7, 2013 - Version 3.2 release published
        After not successful previous version here is a fix.

        July 16, 2013 - Version 3.1 release published

        Jun 26, 2013 - Version 3.0 release published

        April 29, 2013 - Version 3.0 Public community technical preview 2 release published

        April 15, 2013 - Version 3.0 Public community technical preview release published

         

        History

        Our Blogs



        Viewing all 125 articles
        Browse latest View live


        <script src="https://jsc.adskeeper.com/r/s/rssing.com.1596347.js" async> </script>