LocalModerationMatrix

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

LocalModerationMatrix

★ 9 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://pypi.org/project/localmoderationmatrix/)

**Using pip:**

```bash
pip install localmoderationmatrix
```

**Using uv:**

```bash
uv tool install localmoderationmatrix
```

**Standalone Executable:** [GitHub Releases](https://github.com/berkaygediz/LocalModerationMatrix/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

```bash
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:**

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

**Scan with a wordlist and log actions:**

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

**Delete media older than 90 days:**

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

**Interactive Mode (Scan once, filter instantly):**

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

## Building from Source

**PyPI Package:**

```bash
uv build
```

**Standalone Executable:**

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

## License

Apache-2.0

LocalModerationMatrix

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README