localmoderationmatrix 1.1.0

A CLI tool for bulk message deletion, media cleanup, and sticker purge in public Matrix rooms.

LocalModeration for Matrix

A CLI tool for bulk message deletion, media cleanup, and sticker purge in public (unencrypted) Matrix rooms. Encrypted messages are skipped automatically.

Installation

View on PyPI: pypi.org/project/localmoderationmatrix

Using pip:

pip install localmoderationmatrix

Using uv:

uv tool install localmoderationmatrix

Standalone Executable: GitHub Releases

Session

Once logged in, your session is saved in your home directory. Just enter your User ID on the next run to auto-login. If you need to clear the saved session, type reset as your User ID.

Usage

localmoderationmatrix <room_id> [options]

Parameters

Parameter	Description
room_id	(Required) The Matrix room ID.
--search	Search for a single keyword.
--file	Search using a wordlist file (one word per line).
--interactive	Scan room once and enter Interactive Hub mode.
--purge-media	Delete media older than X days (0 for all).
--purge-sticker	Delete stickers older than X days (0 for all).
--log-room	Room ID to send moderation logs.
--days	Time filter: Days (Default: 0).
--hours	Time filter: Hours (Default: 1).
--minutes	Time filter: Minutes (Default: 0).
--homeserver	Custom homeserver URL.

Interactive Keys

• y : Delete.
• n : Skip.
• a : Delete All remaining items automatically.
• q : Quit current review (returns to menu in Interactive Mode).

Examples

Search for a keyword:

localmoderationmatrix "!roomID:matrix.org" --search "spam"

Scan with a wordlist and log actions:

localmoderationmatrix "!roomID:matrix.org" --file words.txt --days 7 --log-room "!LogRoomID:matrix.org"

Delete media older than 90 days:

localmoderationmatrix "!roomID:matrix.org" --purge-media 90

Interactive Mode (Scan once, filter instantly):

localmoderationmatrix "!roomID:matrix.org" --interactive --days 7

Building from Source

PyPI Package:

uv build

Standalone Executable:

pyinstaller --onefile --name LocalModerationMatrix --clean --noconfirm --optimize 2 --collect-all localmoderationmatrix src/localmoderationmatrix/cli.py

License

Apache-2.0