Clisk, the Command-Line Interface for Skype

General Information

This page is laid out for easy navigation via JAWS:

Other screen readers should provide similar navigation commands.

Revision 2.5.1

This release contains many enhancements over 2.4.0. At this writing, the online Users Guide is mostly updated to reflect the changes in this release, but some items have yet to be added to the Guide.

New and enhanced Clisk commands:

Fixes:

Download: Revision 2.5.1 Zip

Revision 2.4.0

This release contains several enhancements over 2.3.2. At this writing, the online Users Guide is not updated to reflect the changes in this release.

New features:

Fixes in this release:

Download: Revision 2.4.0 Zip

Revision 2.3.2

This release contains several enhancements over 2.3.0. At this writing, the online Users Guide is not updated to reflect the changes in this release.

Changes in the WhoIs command:

Other features since 2.3.0:

Fixes since 2.3.0:

Download: Revision 2.3.2 Zip

Revision 2.3.0

This release contains several enhancements over 2.2.0. The online Users Guide is also up to date with this release.

New features since 2.2.0:

Bug fixes since 2.2.0:

Download: Revision 2.3.0 Zip

Revision 2.2.0

This release contains numerous enhancements over 2.1.1. The online Users Guide is also up to date with this release.

WARNING: There are some changes in existing commands in Clisk in this release. Please take time to read at least the first section below before downloading this update, so you are not confused later.

Major Interface Changes

The voicemail commands have changed to make them group properly into a set:

As usual, you can type just the unique part of those commands; for example, vmp for vmPlay. Anyone wishing to keep the old interface may of course do so by defining aliases as follows:
alias pvm vmPlay
alias pvmc vmToCall
alias svm vmStop
alias dvm vmDelete

The AA (AutoAction) command rules have changed slightly as follows:

AA bob a
will add the a flag for Bob but will not remove other flags Bob may have as before. In other words, this command is now exactly equivalent to
AA bob +a
If you really want to give Bob the a flag and also clear all other flags Bob may have, use
AA bob =a

A user is no longer allowed to have an a and a j flag at the same time. Setting one will clear the other. Priority autoAnswer flags, discussed below, work similarly; a user may only have one autoAnswer flag at any one time.

Commands that manipulate existing calls, such as hangup, hold, and resume, formerly required you to type a Skype ID or partial Skype ID if you wanted to "name" which call to manipulate. Now, Clisk searches the Skype ID and the display names of the participants in all active (including held and ringing) calls for a match to what you type. This means, for example, that

hangup bob
will search for not just a call with someone whose Skype ID starts with "bob" but also any call with someone whose Skype ID or name contains "bob." If multiple calls match, you will be asked to choose which call you meant.

Other Changes

Download: Revision 2.2.0 Zip

Revision 2.1.1

This release is a minor but somewhat important improvement over 2.1.0: It fixes one rather annoying bug and provides better alias support. It is recommended for all Clisk users. The online Users Guide is also up to date with this release.

The bug fix: All calls in a calls list would indicate in Clisk 2.1.0 that you transferred them from somewhere. This is fixed in 2.1.1.

The improved alias support: Aliases can now include instructions on how to arrange the parameters given by the user on the command line, so you can, for example, write an alias like

alias topic msg %1 /topic %2-
as a quick way to set a chat topic. See the "Creating and Managing Command Aliases" section of the Users Guide for details on how this works.

Download: Revision 2.1.1 Zip

Revision 2.1.0

This release contains quite a number of enhancements over 2.0.0 and is recommended for all users of this utility. The online Users Guide is also up to date with this release.

New Commands and Subcommands Since 2.0.0

Other Enhancements and Fixes Since 2.0.0

Download: Revision 2.1.0 Zip

Revision 2.0.0

This release contains quite a number of enhancements and is recommended for all users of this utility. As of this writing, Clisk 2.0.0 is ahead of the Clisk User's Guide and contains features and behavior not yet documented there. These items are documented here for now. Besides reading what appears below, the best way to find new features is to type "help" or just a question mark (?) in Clisk itself, read the command list, then type "help" or "?" and a command of interest to learn what it can do.

Note that this version is the first version officially called Clisk rather than Skctl.

Enhancements and Fixes since 1.2.6

The biggest enhancement in 2.0.0 is probably the new handling of Skype user selection in commands. In older versions, Skype user IDs were just accepted and used without question, which could cause embarrassing accidents on a typo. Starting in 2.0.0, several commands incorporate a system that finds the user you want without making you know or type the full Skype ID for the user. Details follow the list of enhancements.

Other new commands and features since 1.2.6:

Other enhancements since 1.2.6:

Bug fixes since 1.2.6:

The New User Selection System

As of Clisk 2.0.0, many commands allow partial user IDs or names to be typed in place of full Skype IDs. This eases user selection while also protecting against typos and major accidents resulting from them. The specific commands supporting this new system currently are aa, call, add, transfer, message / msg, lo, os, and whois. Raw Skype API commands not listed here that require user IDs still require exact user IDs to be typed.

For commands supporting the new user selection system, anything you type for a user name will be handled thus:

Some examples:

msg . Hello there!
Sends "Hello there!" to the user currently selected in the Skype interface.
call !echo123
Call echo123 without a search for that ID, which means it works whether echo123 is in your contact list or not.
call doug
Call the user whose ID or full name contains "doug." If no such user is found, you will be asked whether to call the user with an actual Skype ID of "doug" or just cancel the call. If more than one "doug" is found, you will be shown a list and allowed to select the one to call.

Known Issues In This Release

I receive occasional reports of the following problem: If you call someone and get transferred to voicemail, the Hangup command may not hang up the call. Worse, if the voicemail starts recording, the Windows Skype Alt+PGDN hotkey, if set up, may not properly close the voicemail either. This appears to be a Skype API issue, though this is not a certainty yet. I know of this issue only on Windows at this point. The workaround on Windows is to use the Hangup hotkey for Skype itself to hang up before the voicemail starts recording.

If there is a temporary disconnect between Skype and Clisk, incoming chat messages may not read correctly after the connection is reestablished. A typical indication that this is about to start happening is the message "SkypeAPIError: Skype API error, check if Skype wasn't closed" appearing in the Clisk window when you try to do something. Incoming chat messages thereafter may just say "received" without actually showing the message text. If you see the above error message and want to avoid this issue, just close and restart Clisk once. The precise cause of this issue is not yet determined.

Download: Revision 2.0.0 Zip

Revision 1.2.6

This release contains a number of enhancements and fixes and is recommended for all Skctl users.

Changes since 1.2.5:

See the Skctl User's Guide for more information on Skctl.

Download: Revision 1.2.6 Zip

Revision 1.2.5

This is the fourth public release of Skctl. This release contains numerous improvements over 1.2.4.

For starters, there are significant improvements in the help system:

Other improvements over 1.2.4:

See the Skctl User's Guide for more information on Skctl.

Download: Revision 1.2.5 Zip

Revision 1.2.4

This is the third public release of Skctl. Improvements over 1.2.3:

See the Skctl User's Guide for more information on Skctl.

Download: Revision 1.2.4 Zip

Revision 1.2.3

This is the second public release of Skctl. Improvements over 1.2.2:

See the Skctl User's Guide for more information on Skctl.

Download: Revision 1.2.3 Zip

Revision 1.2.2

This is the first public release of Skctl. As such, the "release notes" are the Skctl User's Guide.

Download: Revision 1.2.2 Zip