endcord-image-pfp
July 14, 2026 ยท View on GitHub
An extension for endcord discord TUI client, that adds drawing rounded profile pictures in the chat using kitty protocol.
Should work on all terminals with kitty image protocol support.
If running in tmux, dont forget to set allow-passthrough.
Other kitty image protocol endcord extensions: endcord-image-inline, endcord-image-emoji.
Installing
See official extensions documentation for installing instructions. Available options:
- Git clone into
Extensionsdirectory located in endcord config directory. - Run
endcord -i https://github.com/sparklost/endcord-image-pfp - Or use endcord client-side command
install_extension sparklost/endcord-image-pfp
Configuration
All extension options are under [main] section in endcord config. This extension options are always prefixed with ext_image_pfp_.
Note that many options can significantly impact RAM and CPU usage.
Settings options
ext_image_pfp_round = True
Convert profile pictures to circular shape. Needs either endcord full or medium, or imagemagick or graphicsmagick installed.
After toggling this, deletepfp-smalldirectory in endcord cache to apply this option.ext_image_pfp_antialias = True
Antialias circle edge ifext_image_pfp_roundisTrue.
After toggling this, deletepfp-smalldirectory in endcord cache to apply this option.ext_image_pfp_max_cache_age = None
If this key exists, it will override endcord builtin value frommax_thumb_cache_ageonly for pfp cache.
Images not used for more than this many days will be deleted on endcord startup.ext_image_pfp_format_message_shift = [0, 5]
Insert spaces toformat_messagefrom endcord them config (also toformat_message_color) to make space for pfp image.
Leave like this if you did not changeformat_messagein theme.
Image is 4x2 cells large and always drawn at x=0 relative to chat left edge, and y=0 relative to message base line.
If message base is not in 2 lines (no\ninformat_message), then image is drawn smaller: 2x1 cells.
In this example, 5 spaces are inserted at index 0.ext_image_pfp_format_message_grouped_shift = [2, 1]Same as above, but forformat_message_grouped.ext_image_pfp_format_newline_shift = [2, 1]Same as above but forformat_newline.
Disclaimer
Warning
Using third-party client is against Discord's Terms of Service and may cause your account to be banned!
Use endcord and/or this extension at your own risk!
If this extension is modified, it may be used for harmful or unintended purposes.
The developer is not responsible for any misuse or for actions taken by users.