PluralKit/docs/content/tips-and-tricks.md
2022-01-14 22:30:02 -05:00

3.4 KiB

layout permalink title next
default /tips Tips and Tricks false

Tips and Tricks

Use command shorthands

PluralKit has a couple of useful command shorthands to reduce the typing:

Original Shorthand
pk;system pk;s
pk;system list pk;s l
pk;system list full pk;s l f
pk;system fronter pk;s f
pk;system fronthistory pk;s fh
pk;system frontpercent pk;s fp
pk;member pk;m
pk;member new pk;m n
pk;group pk;g
pk;group new pk;g n
pk;switch pk;sw
pk;message pk;msg
pk;autoproxy pk;ap

Member list flags

There are a number of option flags that can be added to the pk;system list command.

Sorting options

Flag Aliases Lists Description
-by-name -bn Member, Group Sort by name (default)
-by-display-name -bdn Member, Group Sort by display name
-by-id -bid Member, Group Sort by ID
-by-message-count -bmc Member Sort by message count (members with the most messages will appear near the top)
-by-created -bc Member, Group Sort by creation date (least recently created will appear near the top)
-by-last-fronted -by-last-front, -by-last-switch, -blf, -bls Member Sort by most recently fronted
-by-last-message -blm, -blp Member Sort by last message time (members who most recently sent a proxied message will appear near the top)
-by-birthday -by-birthdate, -bbd Member Sort by birthday (members whose birthday is in January will appear near the top)
-reverse -rev, -r Member, Group Reverse previously chosen sorting order
-random Member, Group Sort randomly

Filter options

Flag Aliases Lists Description
-all -a Member, Group Show all members/groups, including private members/groups
-private-only -po Member, Group Only show private members/groups

::: warning You cannot look up private members or groups of another system. :::

Additional fields to include in the search results

Flag Aliases Lists Description
-with-last-switch -with-last-fronted, -with-last-front, -wls, -wlf Member Show each member's last switch date
-with-last-message -with-last-proxy, -wlm, -wlp Member Show each member's last message date
-with-message-count -wmc Member Show each member's message count
-with-created -wc Member, Group Show each item's creation date
-with-avatar -wa, -wi, -ia, -ii, -img Member, Group Show each item's avatar URL
-with-pronouns -wp Member Show each member's pronouns in the short list (shown by default in full list)

Miscellaneous flags

Command Flag Aliases Description
List commands -search-description -sd Search inside descriptions instead of member/group names
pk;system frontpercent -fronters-only -fo Show the system's frontpercent without the "no fronter" entry
pk;system frontpercent -flat Show "flat" frontpercent - percentages add up to 100%
pk;group <group> frontpercent -fronters-only -fo Show a group's frontpercent without the "no fronter" entry
pk;group <group> frontpercent -flat Show "flat" frontpercent - percentages add up to 100%
Most commands -all -a Show hidden/private information
Most commands -raw -r Show text with formatting, for easier copy-pasting
All commands -private -priv Show private information
All commands -public -pub Hide private information
All commands, except delete -y -yes Skip confirmation prompt