It has a helper script, called
tdmctl to manage tdm sessions. Each tdm session
is a symlink to an executable script that will be called in place of the final
There are two types of tdm sessions :
X: this session is started within the
.xinitrcfile as part of the
startxcall (use this for X window manager/desktop environments)
extra: this session is started in the shell (use this for wayland sessions, tmux wrappers, etc...)
A tdm session can also be either active or inactive. An active tdm session is present in the tdm session selection screen, while an inactive tdm session is not shown. If the path is not an executable file, the tdm session is always counted as inactive.
As shown below, TDM has both a text and dialog mode:
make install from the source directory (you can optionally set
The dependencies are :
- dialog (optional, for the curses interface)
- To install
tdmfor your local user, run
tdmctl init tdmctl add <session name> <executable path> [X(default)/extra]
This will copy the tdm configuration directory to your home directory.
You must then edit your
.zprofile, etc...) file to call
tdmas last command (this will launch tdm once you log into a tty). If you want to allow multiple X sessions, you must use the
.xinitrcfile, you must then replace the exec line with
exec tdm --xstart, which will start your X session (if you do not have a
.xinitrcfile, create a new one with this line in it).
See also the ArchWiki page.
If no session was executed, returns 1. Otherwise 0.
There are two scripts in the TDM configuration directory (
that are run at the begin and end of
tdminitis run prior to the selection screen (when
tdmis called without
tdmexitexecuted right before the
startxcommand is called (in the
Initialize the config directory
List available (active) sessions
tdmctl list: list available sessions (X and extra)
List cached (inactive) sessions
See which command is called by the session
tdmctl check <session> tdmctl check extra/<session>
Show or set default session
tdmctl default [session]
Add a session (it is immediately active)
tdmctl add <name> <path> [X(default)/extra]
tdmctl remove <session>
Enable or disable session
tdmctl enable/disable <session>
Migrate configuration to XDG compliant directory
This project follows the semantic versioning guidelines provided at
semver.org with versions numbered as
MAJOR.MINOR. REVISION :
MAJORis increased after a backwards incompatible API change.
MINORis increased after a backwards compatible API change.
REVISIONis increased after a change with no effect on the API.
Any version with
MAJOR being 0 should not be considered stable nor
should its API.
Versions history can be found in the file ChangeLog.md
This repository uses git flow.
This file is part of tdm.
tdm is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
tdm is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with tdm. If not, see http://www.gnu.org/licenses/.
Currently maintained by dopsi.
This is a fork of the TDM display manager program by mytbk. The original source can be found at here.