---
name: "simctrl"
section: "1"
platform: "linux"
package: "sim"
version: "0.9.5~svn20080806-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/simctrl"
---

# simctrl(1)

Sim-IM Instant Messenger controller

## NAME

simctrl - Sim-IM Instant Messenger controller

## SYNOPSIS

**simctrl** \[*options*\] \[*uin files*\]

## DESCRIPTION

**simctrl** is command line controller for  [**sim**(1)](/sim/1.md) which is a simple and powerful multi-protocol instant messenger. **simctrl** executes commands either interactively or in batch mode. Running **simctrl** without options switches **simctrl** to interactive mode when simctrl waits for commands and sends. Running **simctrl** with **-c** *command* switches simctrl to batch mode. In both modes simctrl talks with running instance of  [**sim**(1)](/sim/1.md).

## OPTIONS

- *uin files*

  UIN files

- **-h**

  Show help about options

- **-c** *command*

  execute *command* on running **sim (1)** instance.

- **-s** *socket*

  use socket file *socket* for communication with running **sim (1)**.

## COMMANDS

Below are commands **simctrl** recognizes. Commands are processed case-insensitively.

- **STATUS**

  set status

- **INVISIBLE**

  set invisible mode

- **MAINWINDOW**

  show/hide main window

- **SEARCHWINDOW**

  show/hide search window

- **QUIT**

  quit SIM

- **CLOSE**

  close session

- **HELP**

  command help information

- **ADD**

  add contact

- **DELETE**

  delete contact

- **OPEN**

  open contact

- **FILE**

  process UIN file

- **CONTACTS**

  print contact list

- **SENDFILE**

  send file

- **GROUP**

  get group name

- **SHOW**

  open unread message

- **SMS**

  send SMS

## SEE ALSO

[**sim**(1)](/sim/1.md).

Information and help about SIM-IM can be found at project's site **http://sim-im.org/**

SIM is based on KDE and QT. Information about KDE project can be found at  **http://kde.org/**

The full documentation for **Qt** is maintained as a Texinfo manual.  If the **info** and **Qt** programs are properly installed at your site, the command

-

  **info Qt**

should give you access to the complete manual. More information about Qt can be found at Trolltech's site **http://doc.trolltech.com/qt.html**

## AUTHORS

SIM-IM Team, see **http://sim-im.org/** and **/usr/share/doc/sim/AUTHORS.sim**