toteph42 / identity_switch
This plugin allows users to switch between different identities (and check for new mails) in a single Roundcube session.
Package info
github.com/toteph42/identity_switch
Type:roundcube-plugin
pkg:composer/toteph42/identity_switch
Requires
- php: >=8.1
- ext-ctype: *
- roundcube/plugin-installer: >=0.1.3
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
- dougluce/ident_switch: *
- elm/identity_smtp: *
Replaces
None
This package is auto-updated.
Last update: 2026-11-12 15:28:32 UTC
README
This plugin allows users to switch between different identities in a single RoundCube session like this:
If you receive new mails, the number of new mails will be shown in identity selection menue.
Where to start
- In settings interface create new identity.
- Be sure to fill in the Name of identity.
- After you have created at least one identity you will see combobox instead of plain text field where your account name was displayed before. There you can switch between the identifities.
Settings
From now on all user preferences and connection settings will belong to the active identity. To indicate for which dentity you're changing preferences, you will see the identity in the header line in format [ Identity: {Active Identity} ] in the Preference menue.
There are some new setting available in Preference -> Mailbox view.
- Check all folders... - Select this option, if you want all folders to be check for new mails.
- Display browser notification... - Select this option, if you want to get a changed icon for this site. Please be aware, that the icon will change only one time, even if there a new mails for multiple identities available (until next new-mail check-cycle is started).
- Display desktop notification... - Select this option, if you want to get a desktop notification about how many new mails were available. Please be aware, you need to allow your mail server site in your browser configuration to send notifications to your desktop.
- Close desktop notification - Specify how many seconds should be visible before it is automatically been closed.
- Play sound... - Select this option, if you want a sound notification. Please be aware, that only sound will be played one time only, even if there are new mails for multiple identities available (until next new-mail check cycle is started). If you hear no sound playing, please check your browser settings, if auto-play of sound files is enabled.
Configuration
- All plugin settings were defined in
default.inc.php. For a descption about all supported RoundCube connection parameters please refer to[base dir]/config/default.inc.php. - If you want to apply your own configurtion changes, please copy file
default.inc.phptoconfig.inc.phpand change the preferences in this file. - All preferences will override RoundCube connection settings for active identity.
- Depending on configuration variable
cfg_typyou'll see different option to edit when selecting a identity to edit. Either it is completely disabled or you may add IMAP and SMTP informations or you'll see a text box, allowing you to edit all connection paramaters in detail. - Only
cfg_typ = 2: All passwords were show as ●●●●●●●●. If you change your password by entering visible text, it will be encrypted immediately after you hit the SAVE button. - If you want to change sound, icon or desktop icon, please change
alert.mp3,alert.icoandalert.gifin directoryassets.
Locking configuration
You may use the dont_override configuration option in your RoundCube configuration file config/config.inc.php to lock settings from being overriden. Plugin connection settings cannot be locked.
Performance
New mail checking is performed in background asynchronously. This has the effect that the new mail counter is not always updated immediately after login - it may take some time before this has been performed. It heavily depends on the number of identities you're using.
If you've select Check all folders, this has a huge impact on the time new-mail checking need to collect information. If you have hundreds of folders in your mail box, each of the boxes will be checked for new mails.
Depending on the workload on your host, it migth happen, that the menue isn't opened as quick as expected. This depend on how RoundCube is able to handle the synchroneous Ajax requests.
Version compatibility
Versions 3.x - for RoundCube v1.6.x and 1.7.x requires PHP version >= 8.0.0.
Limitations
This plugin only supports Elastic skin. If you wan't to get another skin to be supoorted, then please contact me. I can add support for other skins if you pay for it. Or you modify plugin according to your needs and send me your changes.
License
This plugin is released under the [GNU General Public License v3.0].
Migration
If you want to migrate plugin data from version 2.x, there is a small PHP script available. This can be called by entering[URL]/plugin/identity_switch/idnetity_switch_migrate.php in you favorite browser. You should then see at least two messages:
Trying to delete table "identity_switch"...
0 identities successfully migrated.
Debugging
If you encounter problems with plugin, take a look at the debug options available in default.inc.php.
If you encounter connection problems, it is a good idea to enable RoundCube available debugging options.
Donation
If you like this software and you want support my work, feel free to send me a donation:

