README

Watchtower adds a Settings → Watchtower panel intended for session monitoring and login activity visualization.

This baseline:

Wires a new Settings action: Watchtower
Reads the Roundcube session table and shows recent sessions (user, IP, host, last activity)
Uses two separate images for the Settings icon (normal + active) in Larry
Keeps layout simple so it works with Larry variants and Elastic

Installation

Extract the watchtower directory into your Roundcube plugins/ folder:
```
plugins/watchtower/
```

Copy the config template and adjust if needed:

cd plugins/watchtower
cp config.inc.php.dist config.inc.php

Enable the plugin in your Roundcube config/config.inc.php:
```
$config['plugins'][] = 'watchtower';
```

Skins & Icons

Larry (and my 10 Colorized Larry Variants):
- Two separate images for the Settings icon: normal and active.
- Icons live in skins/larry/images/ as SVGs you can replace.
Elastic:
- Neutral layout and CSS, no sprite assumptions.
Classic (I am nostalgic):
- Neutral layout and CSS, no sprite assumptions.

Extending Watchtower

Next steps I want to add to this plugin:

Define "active" vs "stale" session rules.
Create your own watchtower_sessions table and log full login events including user-agent and geoinfo.
Add filters and a "suspicious activity" tab.

Enjoy!

💰 Donations 💰

If you use this plugin and would like to show your appreciation by buying me a cup of coffee, I surely would appreciate it. A regular cup of Joe is sufficient, but a Starbucks Coffee would be better ...
Zelle (Zelle is integrated within many major banks Mobile Apps by default) - Just send to texxasrulez at yahoo dot com
No Zelle in your banks mobile app, no problem, just click Paypal and I can make a Starbucks run ...

I appreciate the interest in this plugin and hope all the best ...

Screenshot

Versioning

watchtower now keeps its canonical version in watchtower::PLUGIN_VERSION inside watchtower.php.
watchtower::info() exposes the plugin metadata array used for self-identification.
Development builds should use a +dev suffix such as 1.0.0+dev.
Release builds should use a clean tagged version such as 1.0.0.

For a release bump:

Update watchtower::PLUGIN_VERSION in watchtower.php or run sh scripts/bump-version.sh 1.0.0.
Update CHANGELOG.md.
Create the matching release tag after verification.

texxasrulez / watchtower

Maintainers

Package info

Statistics

Security