You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
94 lines
1.7 KiB
94 lines
1.7 KiB
# Message filters
|
|
|
|
You can use a special notation to filter messages that you want to have included in an export. The notation syntax is designed to mimic Discord's search query syntax, but with additional capabilities.
|
|
|
|
To configure a filter, specify it in advanced export parameters when using the GUI or by passing the `--filter` option when using the CLI.
|
|
|
|
## Examples
|
|
|
|
- Filter by user
|
|
|
|
```
|
|
from:Tyrrrz
|
|
```
|
|
|
|
- Filter by user (with discriminator)
|
|
|
|
```
|
|
from:Tyrrrz#1234
|
|
```
|
|
|
|
- Filter by message content (allowed values: `link`, `embed`, `file`, `video`, `image`, `sound`)
|
|
|
|
```
|
|
has:image
|
|
```
|
|
|
|
- Filter by mentioned user (same rules apply as with `from:` filter)
|
|
|
|
```
|
|
mentions:Tyrrrz#1234
|
|
```
|
|
|
|
- Filter by contained text (has word "hello" and word "world" somewhere in the message text):
|
|
|
|
```
|
|
hello world
|
|
```
|
|
|
|
- Filter by contained text (has the string "hello world" somewhere in the message text):
|
|
|
|
```
|
|
"hello world"
|
|
```
|
|
|
|
- Combine multiple filters ('and'):
|
|
|
|
```
|
|
from:Tyrrrz has:image
|
|
```
|
|
|
|
- Same thing but with an explicit operator:
|
|
|
|
```
|
|
from:Tyrrrz & has:image
|
|
```
|
|
|
|
- Combine multiple filters ('or'):
|
|
|
|
```
|
|
from:Tyrrrz | from:"96-LB"
|
|
```
|
|
|
|
- Combine multiple filters using groups:
|
|
|
|
```
|
|
(from:Tyrrrz | from:"96-LB") has:image
|
|
```
|
|
|
|
- Negate a filter:
|
|
|
|
```
|
|
-from:Tyrrrz | -has:image
|
|
```
|
|
|
|
- Negate a grouped filter:
|
|
|
|
```
|
|
-(from:Tyrrrz has:image)
|
|
```
|
|
|
|
- Escape special characters (`-` is escaped below, so it's not parsed as negation operator):
|
|
|
|
```
|
|
from:96\-LB
|
|
```
|
|
|
|
## CLI Caveat
|
|
|
|
Negated filters (those that start with `-`) may cause parsing issues when using the CLI version of DiscordChatExporter. To avoid this, use the tilde (`~`) character instead of the dash (`-`):
|
|
|
|
```
|
|
DiscordChatExporter.Cli export [...] --filter ~from:Tyrrrz
|
|
```
|