Miscellaneous
Social Lookups & Feeds
Profile lookups and feed notifications for popular platforms.
Slash commands for this page
Set this up in Discord with /configure feature:Creator feeds, or on the dashboard under Feeds › TikTok.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,instagram→/instagram,ig→/instagram,kick→/kick,ping→/ping,userinfo→/user info,tiktok add→/tiktok add
,tiktok remove→/tiktok remove,tiktok list→/tiktok list,tiktok reset→/tiktok reset,tiktok message→/tiktok message,tiktok variables→/tiktok variables,instagram add→/instagram add,instagram remove→/instagram remove,instagram list→/instagram list,instagram clear→/instagram clear,instagram live→/instagram live,instagram message→/instagram message,instagram variables→/instagram variables,x reposts→/x reposts,x add→/x add,x remove→/x remove,x list→/x list,x reset→/x reset,x message→/x message,x ping→/x ping,x variables→/x variables,roblox profile→/roblox profile,roblox history→/roblox history,roblox games→/roblox games,roblox game→/roblox game,roblox groups→/roblox groups,roblox group→/roblox group,roblox outfits→/roblox outfits,roblox item→/roblox item,rolimons profile→/roblox rolimons profile,rolimons chart→/roblox rolimons chart,valorant profile→/gaming valorant profile,valorant agents→/gaming valorant agents,valorant maps→/gaming valorant maps,valorant weapon→/gaming valorant weapon,valorant skin→/gaming valorant skin,minecraft player→/gaming minecraft player,minecraft server→/gaming minecraft server,spotify track→/social spotify track,spotify artist→/social spotify artist,spotify album→/social spotify album,spotify preview→/social spotify preview,github profile→/social github profile,github 2email→/social github 2email,github repository→/social github repository,x user→/x user,x post→/x post,instagram user→/instagram user,instagram posts→/instagram posts,instagram post→/instagram post,league profile→/gaming league profile,league champion→/gaming league champion,league rotation→/gaming league rotation,bio guns→/social guns view,bio haunt→/social haunt view,fortnite map→/gaming fortnite map,fortnite news→/gaming fortnite news,fortnite view→/gaming fortnite view,bio guns profile→/social guns profile,bio guns connect→/social guns connect,bio guns disconnect→/social guns disconnect,bio haunt profile→/social haunt profile,bio haunt connect→/social haunt connect,bio haunt disconnect→/social haunt disconnect,soundcloud→/configure feature:Creator feeds,sc→/configure feature:Creator feeds,twitch ping→/configure feature:Creator feeds,twitch add→/configure feature:Creator feeds,twitch remove→/configure feature:Creator feeds,twitch list→/configure feature:Creator feeds,twitch reset→/configure feature:Creator feeds,twitch message→/configure feature:Creator feeds,youtube live→/configure feature:Creator feeds,youtube add→/configure feature:Creator feeds,youtube remove→/configure feature:Creator feeds,youtube list→/configure feature:Creator feeds,youtube reset→/configure feature:Creator feeds,youtube message→/configure feature:Creator feeds,youtube ping→/configure feature:Creator feeds,pinterest add→/configure feature:Creator feeds,pinterest remove→/configure feature:Creator feeds,pinterest list→/configure feature:Creator feeds,pinterest reset→/configure feature:Creator feeds,pinterest message→/configure feature:Creator feeds,pinterest ping→/configure feature:Creator feeds,soundcloud add→/configure feature:Creator feeds,soundcloud remove→/configure feature:Creator feeds,soundcloud list→/configure feature:Creator feeds,soundcloud reset→/configure feature:Creator feeds,soundcloud message→/configure feature:Creator feeds,soundcloud ping→/configure feature:Creator feeds,lastfm spotify→/configure feature:Last.fm,lastfm youtube→/configure feature:Last.fm,lastfm discoverydate→/configure feature:Last.fm,kicklive→@greed kicklive,kickalerts→@greed kickalerts,twitch variables→@greed twitch variables,youtube variables→@greed youtube variables,pinterest variables→@greed pinterest variables,soundcloud variables→@greed soundcloud variables,kicklive add→@greed kicklive add,kicklive remove→@greed kicklive remove,kicklive list→@greed kicklive list,kicklive reset→@greed kicklive reset,kicklive message→@greed kicklive message,kicklive ping→@greed kicklive ping,kicklive variables→@greed kicklive variables,bio leaderboard→@greed bio leaderboard
Overview
greed integrates with popular social platforms to provide two distinct features:
- Feed Notifications: Automatically post updates to Discord when creators go live or publish something new: TikTok, Twitch, YouTube, Instagram, X, Pinterest, SoundCloud and Kick.
- Profile Lookups: Query user profiles, stats, and game information across multiple platforms (Roblox, Valorant, Spotify, Minecraft, GitHub, and more).
Feed Notifications
Set up live feed notifications to post creator updates directly to a channel. Up to 10 feeds per guild per platform.
greed checks each creator on a schedule shared by every server following them. If any of those servers has Server Premium, that creator is checked three times as often: so a new video, post or stream reaches your channel sooner. Live alerts (Twitch and Kick) are already checked at their fastest rate for everyone.
Pinterest, SoundCloud and Kick are prefix-only commands: Discord caps a bot at 100 slash commands and greed is at that limit, so these three are driven with the , prefix or from the dashboard. Every other feed platform works on both surfaces.
The dashboard assistant can follow a creator on any of these platforms, move a feed to another channel, change or reset its custom message, and stop following a creator. Name the creator by handle, name or profile link; if several creators match, it asks which one you mean. You approve each change first, you need Manage Server, and the same per-platform limits and premium requirements apply.
TikTok Feeds
Post new uploads from TikTok creators in a channel.
,tiktok add (username) (channel),tiktok add @greed #announcementsTikTok feeds check for new posts every 20 seconds. Up to 10 creators per server.
,tiktok add (username) (channel): Start following a creator's uploads.,tiktok remove (username): Stop following a creator.,tiktok list: View all creators your server follows.,tiktok reset: Remove all TikTok feeds at once.
,tiktok message (username) [script]: Set a custom notification message (supports variables).,tiktok variables: Show available message variables ({username},{caption},{likes}, etc.).
greed must have permission to send messages in the target channel. If a creator's account is deleted or suspended, their feed will stop posting automatically.
Instagram Feeds
Post an account's new uploads in a channel, and optionally announce when they go live.
,instagram add (username) (channel),instagram add greed #announcementsgreed checks tracked accounts every 2 minutes for new posts. Live status is checked at most every 10 minutes. Up to 10 accounts per server. ,instagram also answers to ,ig.
,instagram add (username) (channel): Start following an account's uploads.,instagram remove (username): Stop following an account (aliases:delete,del,rm).,instagram list: List the accounts this server follows (aliases:show,all).,instagram clear: Stop following every account (alias:reset).
,instagram live (username) [state]: Toggle live announcements for a tracked account. Passonoroffto set it explicitly, or leave it off to flip the current setting.
The account has to be tracked with ,instagram add first: live announcements are a setting on an existing feed, not a separate feed.
,instagram message (username) [script]: Set the message posted for that account's uploads (aliases:msg,template). Run it with no script to see the current one.,instagram variables: Show the variables available in feed messages (alias:vars).
Feed variables:
| Variable | Output |
|---|---|
{instagram.url} | Link to the post. Required: a template without it is rejected. |
{instagram.caption} | The post's caption. |
{instagram.id} | The post's ID. |
{instagram.created} | When the post went up. |
{instagram.likes} | Like count, shortened (e.g. 12.4K). |
{instagram.comments} | Comment count, shortened. |
{instagram.type} | image, video or carousel. |
{instagram.media} | Direct URL to the first media item. |
{instagram.creator} | The account's username. |
{instagram.creator.url} | Link to the account's profile. |
{instagram.creator.avatar} | The account's profile picture. |
Feed management commands require Manage Server. Private accounts cannot be tracked: greed only sees what a logged-out visitor sees.
Twitch Alerts
Announce when a Twitch channel goes live.
,twitch add (login) (channel),twitch add greedbot #twitch-alertsLive alerts check every minute. You can ping a role when a streamer goes live with ,twitch ping (login) [role].
,twitch add (login) (channel): Announce a channel going live.,twitch remove (login): Stop announcing a channel.,twitch list: View all monitored Twitch channels.,twitch reset: Remove all Twitch feeds at once.
,twitch message (login) [script]: Set a custom alert message.,twitch ping (login) [role]: Ping a role when the channel goes live.,twitch variables: Show available message variables.
If a Twitch channel is set to private or deleted, alerts will stop. Ensure greed can send messages in the target channel.
YouTube Feeds
Post new uploads and live streams from YouTube channels.
,youtube add (channel_name) (channel),youtube add @greed #youtubeYouTube supports channel handles (@name), channel IDs, and URLs. Uploads are checked every 2 minutes and live streams every 5 minutes. You can enable live stream announcements separately with ,youtube live (channel_name).
,youtube add (channel_name) (channel): Start posting a channel's uploads.,youtube remove (channel_name): Stop following a channel.,youtube list: View all YouTube channels your server follows.,youtube reset: Remove all YouTube feeds at once.
,youtube live (channel_name) [enabled]: Toggle live stream notifications for a channel.,youtube message (channel_name) [script]: Set a custom upload message.,youtube ping (channel_name) [role]: Ping a role when the channel uploads or goes live.,youtube variables: Show available message variables.
YouTube channels must be public. If a channel is made private or deleted, feeds will stop posting. The bot requires send-message permissions in the target channel.
X Feeds
Post an account's new posts from X (formerly Twitter) in a channel.
,x add (handle) (channel),x add @greed #announcementsX feeds check every 3 minutes. Reposts are included by default and are labelled as reposts: turn them off per feed with ,x reposts (handle) off.
,x add (handle) (channel): Start following an account's posts.,x remove (handle): Stop following an account.,x list: View all accounts your server follows.,x reset: Remove all X feeds at once.
,x reposts (handle) [on|off]: Include or hide the account's reposts.,x message (handle) [script]: Set a custom post message.,x ping (handle) [role]: Ping a role when the account posts.,x variables: Show available message variables.
Replies to other accounts are never posted, but replies an account makes to itself are: so threads still arrive in full.
Feeds follow the account's numeric ID, so a handle change does not break them. Protected (private) accounts cannot be followed.
Pinterest Feeds
Post an account's new pins in a channel, either from every board or from one specific board.
,pinterest add (username) (channel) [board],pinterest add nasa #inspiration first-womanPinterest feeds check every 3 minutes. Leave the board off to follow everything the account saves, on any board. On the dashboard, pick the account and its boards appear underneath.
,pinterest add (username) (channel) [board]: Follow a board, or every board.,pinterest remove (username) [board]: Stop following an account or one of its boards.,pinterest list: View all accounts and boards your server follows.,pinterest reset: Remove all Pinterest feeds at once.
,pinterest message (username) [script] [board]: Set a custom pin message.,pinterest ping (username) [role] [board]: Ping a role when a new pin arrives.,pinterest variables: Show available message variables.
Saving someone else's pin to a board counts as a new pin, because that is what Pinterest shows the account's followers. An account that mostly re-pins will therefore be chatty: following a single board is usually quieter.
Pinterest feeds follow the username, because Pinterest offers no way to look an account up by ID. If the account is renamed its feed stops silently and has to be added again under the new name.
SoundCloud Feeds
Post an artist's new tracks in a channel.
,soundcloud add (artist) (channel),soundcloud add flume #new-musicSoundCloud feeds check every 3 minutes. ,soundcloud also answers to ,sc, and accepts a profile name or a full profile link.
,soundcloud add (artist) (channel): Start following an artist's uploads.,soundcloud remove (artist): Stop following an artist.,soundcloud list: View all artists your server follows.,soundcloud reset: Remove all SoundCloud feeds at once.
,soundcloud message (artist) [script]: Set a custom track message.,soundcloud ping (artist) [role]: Ping a role when the artist uploads.,soundcloud variables: Show available message variables.
Feeds follow the artist's numeric ID, so renaming a profile does not break them. Private tracks are never posted.
Kick Alerts
Announce when a Kick channel goes live.
,kicklive add (channel_name) (channel),kicklive add xqc #live-alertsKick alerts check every minute. The command is ,kicklive (also ,kickalerts) because ,kick is the moderation command for removing a member.
,kicklive add (channel_name) (channel): Announce a channel going live.,kicklive remove (channel_name): Stop announcing a channel.,kicklive list: View all monitored Kick channels.,kicklive reset: Remove all Kick alerts at once.
,kicklive message (channel_name) [script]: Set a custom alert message.,kicklive ping (channel_name) [role]: Ping a role when the channel goes live.,kicklive variables: Show available message variables.
Each broadcast is announced once. Ending and restarting a stream is a new broadcast and announces again, but a brief connection drop on Kick's side will not re-announce the same stream.
Custom Feed Messages
Every social feed supports fully custom notification messages. Use the ,<platform> message command to set a template that renders when new content is posted. Templates use greed's scripting language to combine text, embeds, and interactive components: see Embed Scripting and Components for syntax.
Fallback Behavior
If your custom template renders to nothing (empty text content, no embeds, no components), greed falls back to the built-in default layout for that platform. This lets you use conditionals and optional content without losing notifications.
Twitch Custom Messages
Twitch live alerts use 8 available variables to build rich notifications. The built-in layout shows the streamer's name, stream title, thumbnail, viewer count, category, and a direct link to the stream.
Set ,twitch ping (login) (role) to prepend a role mention to any custom message: the role is added as <@&role_id> before your rendered content.
Twitch Variables
| Variable | Description | Example Value |
|---|---|---|
{twitch.url} | Direct link to the stream | https://twitch.tv/streamername |
{twitch.title} | Stream title | 24-hour charity speedrun! |
{twitch.category} | Game or category name | Just Chatting |
{twitch.game} | Alias for twitch.category | Just Chatting |
{twitch.viewers} | Current viewer count (formatted) | 1,234 |
{twitch.started} | Stream start time as Discord relative timestamp | <t:1692374400:R> |
{twitch.thumbnail} | Thumbnail image URL | https://static-cdn.jtvnw.net/previews-ttv/... |
{twitch.id} | Twitch stream ID | 48573294857 |
{twitch.creator} | Streamer's login (lowercase name) | streamername |
{twitch.creator.name} | Streamer's display name | StreamerName |
{twitch.creator.url} | Streamer's profile URL (alias for twitch.url) | https://twitch.tv/streamername |
Twitch Examples
{twitch.creator.name} is live on Twitch playing {twitch.category}!
{twitch.title}
{twitch.url}{embed}
{title: {twitch.creator.name} is live!}
{description: {twitch.title}}
{color: #9146ff}
{thumbnail: {twitch.thumbnail}}
{field: Category && {twitch.category} && inline}
{field: Viewers && {twitch.viewers} && inline}
{field: Started && {twitch.started}}
{button: label: Watch Stream && url: {twitch.url}}YouTube Custom Messages
YouTube feeds support two distinct events: uploads (new videos or Shorts) and live streams. Each has a different set of available variables. The built-in layout shows the channel name, video title, thumbnail, publication time, and a link.
Enable live stream notifications with ,youtube live (channel_name) on to post when the channel goes live. Upload and live messages can have different custom templates.
YouTube Variables by Event Type
Upload Variables (triggered when a new video or Short is posted):
| Variable | Description | Example Value |
|---|---|---|
{youtube.url} | Link to the video | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
{youtube.title} | Video title | How to make the perfect soufflé |
{youtube.description} | Video description (first 5000 chars) | In this video I show you... |
{youtube.id} | YouTube video ID | dQw4w9WgXcQ |
{youtube.thumbnail} | Thumbnail image URL | https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg |
{youtube.published} | Upload time as Discord relative timestamp | <t:1692374400:R> |
{youtube.type} | Content type: "short" or "video" | video |
{youtube.creator} | Channel name | Culinary Arts Daily |
{youtube.creator.url} | Channel profile URL | https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxx |
Live Stream Variables (triggered when the channel goes live):
| Variable | Description | Example Value |
|---|---|---|
{youtube.url} | Link to the live stream (may be empty initially) | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
{youtube.title} | Stream title | Live Cooking Q&A |
{youtube.description} | Always empty for live streams | `` |
{youtube.id} | Video ID (may be empty initially) | dQw4w9WgXcQ |
{youtube.thumbnail} | Thumbnail image URL (may be empty initially) | https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg |
{youtube.published} | Always empty for live streams | `` |
{youtube.type} | Always "live" for live streams | live |
{youtube.viewers} | Current live viewer count (formatted) | 5,432 |
{youtube.creator} | Channel name | Culinary Arts Daily |
{youtube.creator.url} | Channel profile URL | https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxx |
Live stream variables like url, thumbnail, and id may be empty when the stream first starts. Design templates to handle missing data with optional content or fallback text.
YouTube Examples
New video from {youtube.creator}!
{youtube.title}
{youtube.url}{embed}
{title: {youtube.creator} uploaded}
{description: {youtube.title}}
{color: #ff0000}
{image: {youtube.thumbnail}}
{field: Posted && {youtube.published}}
{button: label: Watch && url: {youtube.url}}{youtube.creator} is live now!
{youtube.title}
{youtube.url}
Viewers: {youtube.viewers}{embed}
{title: {youtube.creator} is LIVE}
{description: {youtube.title}}
{color: #ff0000}
{thumbnail: {youtube.thumbnail}}
{field: Viewers && {youtube.viewers}}
{button: label: Join Stream && url: {youtube.url}}TikTok Custom Messages
TikTok feeds post when creators upload new videos or photos. The built-in layout shows the creator's name, post caption, engagement stats (likes, comments, plays), media thumbnails, and a direct link.
TikTok Variables
| Variable | Description | Example Value |
|---|---|---|
{tiktok.url} | Direct link to the post | https://www.tiktok.com/@username/video/7329482948574839 |
{tiktok.caption} | Post caption text | this took 3 hours... |
{tiktok.id} | TikTok video/photo ID | 7329482948574839 |
{tiktok.created} | Post creation time as Discord relative timestamp | <t:1692374400:R> |
{tiktok.likes} | Like count in compact notation | 1.2K |
{tiktok.comments} | Comment count in compact notation | 342 |
{tiktok.plays} | Play/view count in compact notation | 45.8K |
{tiktok.shares} | Share count in compact notation | 89 |
{tiktok.type} | Content type: "photo" or "video" | video |
{tiktok.creator} | Creator's username (without @) | username |
{tiktok.creator.name} | Creator's display name | User Name |
{tiktok.creator.url} | Creator's profile URL | https://www.tiktok.com/@username |
{tiktok.creator.avatar} | Creator's avatar image URL | https://p16-sign.tiktokcdn.com/avatar-... |
TikTok Examples
{tiktok.creator.name} just posted!
{tiktok.caption}
{tiktok.url}{embed}
{title: New post from {tiktok.creator.name}}
{description: {tiktok.caption}}
{color: #fe2c55}
{thumbnail: {tiktok.creator.avatar}}
{field: Likes && {tiktok.likes} && inline}
{field: Comments && {tiktok.comments} && inline}
{field: Plays && {tiktok.plays} && inline}
{button: label: Open Post && url: {tiktok.url}}X Custom Messages
X feeds post original posts, self-replies (threads) and: unless you turn them off: reposts. {x.type} tells you which one you are rendering, so a single template can handle all three.
X Variables
| Variable | Description | Example Value |
|---|---|---|
{x.url} | Direct link to the post | https://x.com/NASA/status/2090197889947451524 |
{x.text} | Post text | A new school year brings fresh opportunities… |
{x.id} | Post ID | 2090197889947451524 |
{x.media} | First image or video thumbnail, if any | https://pbs.twimg.com/media/… |
{x.published} | Post time as Discord relative timestamp | <t:1786477576:R> |
{x.type} | post, repost or reply | repost |
{x.likes} | Like count (formatted) | 27,325 |
{x.reposts} | Repost count (formatted) | 4,438 |
{x.replies} | Reply count (formatted) | 3,941 |
{x.creator} | Account display name | NASA |
{x.creator.handle} | Account handle without the @ | NASA |
{x.creator.url} | Account profile URL | https://x.com/NASA |
{x.creator.avatar} | Account avatar URL | https://pbs.twimg.com/profile_images/… |
{x.creator.verified} | true when the account is verified | true |
X Examples
{x.creator} posted on X
{x.text}
{x.url}{embed}
{author: {x.creator} && {x.creator.avatar} && {x.creator.url}}
{description: {x.text}}
{color: #1d9bf0}
{image: {x.media}}
{footer: {x.likes} likes • {x.reposts} reposts}
{button: label: Open on X && url: {x.url}}Pinterest Custom Messages
Pinterest feeds post one message per new pin, whether the feed follows a single board or the whole account.
Pinterest Variables
| Variable | Description | Example Value |
|---|---|---|
{pinterest.url} | Direct link to the pin | https://www.pinterest.com/pin/142567144448897971/ |
{pinterest.title} | Pin description | A new school year brings fresh opportunities… |
{pinterest.id} | Pin ID | 142567144448897971 |
{pinterest.image} | Pin image URL | https://i.pinimg.com/736x/… |
{pinterest.published} | Pin time as Discord relative timestamp | <t:1786477576:R> |
{pinterest.creator} | Account display name | NASA |
{pinterest.creator.handle} | Account username | nasa |
{pinterest.creator.url} | Account profile URL | https://www.pinterest.com/nasa/ |
Pinterest Examples
{pinterest.creator} pinned something new
{pinterest.title}
{pinterest.url}{embed}
{title: New pin from {pinterest.creator}}
{description: {pinterest.title}}
{color: #e60023}
{image: {pinterest.image}}
{footer: Pinned {pinterest.published}}
{button: label: Open on Pinterest && url: {pinterest.url}}SoundCloud Custom Messages
SoundCloud feeds post one message per new track, with the artwork, duration and play count available to your template.
SoundCloud Variables
| Variable | Description | Example Value |
|---|---|---|
{soundcloud.url} | Direct link to the track | https://soundcloud.com/flume/all-of-the-worlds |
{soundcloud.title} | Track title | All Of The Worlds |
{soundcloud.description} | Track description | Out now on all platforms |
{soundcloud.id} | Track ID | 2119863225 |
{soundcloud.artwork} | Cover artwork URL | https://i1.sndcdn.com/artworks-…-t500x500.jpg |
{soundcloud.duration} | Track length | 3:42 |
{soundcloud.plays} | Play count (formatted) | 1,204,551 |
{soundcloud.likes} | Like count (formatted) | 48,201 |
{soundcloud.published} | Upload time as Discord relative timestamp | <t:1750942881:R> |
{soundcloud.creator} | Artist display name | Flume |
{soundcloud.creator.handle} | Artist profile name | flume |
{soundcloud.creator.url} | Artist profile URL | https://soundcloud.com/flume |
SoundCloud Examples
{soundcloud.creator} posted a new track: {soundcloud.title} ({soundcloud.duration})
{soundcloud.url}{embed}
{title: {soundcloud.title}}
{url: {soundcloud.url}}
{description: {soundcloud.description}}
{color: #ff5500}
{thumbnail: {soundcloud.artwork}}
{field: Length && {soundcloud.duration} && inline}
{field: Plays && {soundcloud.plays} && inline}
{button: label: Listen on SoundCloud && url: {soundcloud.url}}Kick Custom Messages
Kick alerts fire once per broadcast, with the same shape as Twitch alerts.
Kick Variables
| Variable | Description | Example Value |
|---|---|---|
{kick.url} | Direct link to the stream | https://kick.com/xqc |
{kick.title} | Stream title | 24-hour charity speedrun! |
{kick.category} | Category name | Just Chatting |
{kick.viewers} | Current viewer count (formatted) | 19,325 |
{kick.started} | Stream start time as Discord relative timestamp | <t:1787240701:R> |
{kick.thumbnail} | Stream thumbnail URL | https://images.kick.com/video_thumbnails/… |
{kick.language} | Stream language code | en |
{kick.creator} | Channel name (lowercase) | xqc |
{kick.creator.name} | Channel display name | xQc |
{kick.creator.url} | Channel URL (alias for kick.url) | https://kick.com/xqc |
Kick Examples
{kick.creator.name} is live on Kick playing {kick.category}!
{kick.title}
{kick.url}{embed}
{title: {kick.creator.name} is live!}
{description: {kick.title}}
{color: #53fc18}
{image: {kick.thumbnail}}
{field: Category && {kick.category} && inline}
{field: Viewers && {kick.viewers} && inline}
{button: label: Watch Stream && url: {kick.url}}Role Mentions in Feed Messages
When you set a role ping with ,<platform> ping (target) (role), greed prepends the role mention to your rendered message. The mention is added as <@&role_id> before your template's output, and configured for proper Discord allowedMentions.
If your custom template renders empty, the role mention still appears before the fallback default layout.
Example: If you set a custom Twitch message and assign a role:
,twitch message mystreamer {twitch.creator.name} is live!
,twitch ping mystreamer @StreamAlertsThe posted message will be: <@&123456789012345678> mystreamer is live!
Template Scripting Reference
Custom feed messages use greed's embedded scripting language. Master it with these resources:
- Embed Scripting: Build rich embeds with titles, descriptions, fields, colors, images, and footers.
- Variables: Variable interpolation, conditionals, mentions, and formatting.
- Components: Add buttons, select menus, and text inputs (Components V2).
Key techniques:
- Variables: Wrap any variable in
{...}to interpolate: e.g.,{twitch.creator.name}. - Embeds: Each field is its own node:
{title: ...},{description: ...},{color: #hex},{image: url}. Open with{embed}when a message mixes plain text and embed fields. - Fields and buttons: Arguments are separated by
&&, never commas orkey="value"pairs:{field: Name && Value && inline}and{button: label: Watch && url: https://...}. - Conditionals: Use
{if condition}...{/if}to show content only when conditions are met.
Test your template before deploying to production. The ,<platform> message (target) command (without a script argument) displays your current template.
Common Issues & Troubleshooting
Your template renders to empty content. Check:
- Are all variables spelled correctly? Run
,<platform> variablesto see available keys. - Does your template have text or embeds? Empty conditionals or whitespace-only content triggers the fallback.
- Are there syntax errors in embeds or components? The bot validates templates and won't save invalid scripts.
Role mentions are always prepended to your message. If you need the mention in a different position, include it manually in your template as plain text: e.g., {twitch.creator.name} is live! <@&ROLEID>. Avoid using the ,ping command if you want to control mention placement.
Make sure your custom template includes the required URL variable:
- Twitch requires
{twitch.url}or{twitch.creator.url}. - YouTube requires
{youtube.url}. - TikTok requires
{tiktok.url}. - Instagram requires
{instagram.url}. - X requires
{x.url}. - Pinterest requires
{pinterest.url}. - SoundCloud requires
{soundcloud.url}. - Kick requires
{kick.url}.
The check is case-sensitive and looks for that exact variable, so {X.URL} does not count and {x.creator.url} points at the profile rather than the post.
If the bot rejects your message, it's likely missing this required field.
Live stream metadata (like url, thumbnail, id) may not be available immediately when the stream starts. Use optional syntax or fallback text: {if youtube.url}{youtube.url}{else}Stream just started, link coming soon{/if}.
Pinterest is the one platform greed has to follow by username, because it offers no way to look an account up by ID. A rename orphans the feed silently: remove it and add it again under the new name.
Kick alerts need app credentials configured on the bot. If they are missing, ,kicklive add answers that Kick alerts are not configured rather than adding a feed.
Verify the bot has send-message permissions in the target channel. Re-run ,<platform> add to refresh the feed if permissions were just fixed.
Profile Lookups
Query profiles and stats from gaming and social platforms. All lookups are one-off commands: they don't create persistent feeds.
Roblox Profiles
Look up Roblox user profiles, games, groups, and outfit information.
,roblox profile (username): View a user's profile, status, and social stats.,roblox history (username): See past usernames a player has used.
The profile card shows their avatar, current presence, friend, follower, following and group counts, join date and past names. Buttons along the bottom jump straight to that player's Groups, Games and Outfits without retyping the username.
,roblox games (username): List games a player has created or developed.,roblox game (name): Look up a Roblox game's stats and details.,roblox groups (username): List groups a player is a member of.,roblox group (name): Look up a group's information.
,roblox outfits (username): Display a player's saved outfit templates.,roblox item (name): Search the Roblox catalog for an item.
Some usernames may not be found if the account is private, deleted, or very new. Game and group lookups require exact or partial name matches.
Rolimons
Look up Roblox item values and trading stats via Rolimons.
,rolimons profile (player): View a player's Roblox value, RAP (Recent Average Price), and trading rank.,rolimons chart (player) [range]: Render a graph of a player's value history over time.
Requires a valid Roblox username. The chart displays value trends over the past 7, 30, or 90 days.
Valorant Profiles
Look up player ranks, agents, weapons, and maps.
,valorant profile (name) (tag): View a player's rank, recent match history, and agent stats (e.g.,greed#NA1).
,valorant agents: Browse playable agents and their abilities.,valorant maps: View all Valorant map layouts.,valorant weapon: Browse weapon stats and price info.,valorant skin (name): Search for Valorant weapon skins by name.
Player profiles require the exact Riot ID format: username#tag. If a player's match history is private, only ranked tier will display.
Minecraft
Look up Java Edition player skins and server info.
,minecraft player (username): View a player's skin, UUID, and account history.
,minecraft server (address): Check a server's status, MOTD, player count, and version.
Only supports Java Edition. Bedrock players and servers are not supported. Server checks require the server to have query enabled.
Spotify
Search and preview tracks, albums, and artists.
,spotify track (query): Look up a track and get album/artist info.,spotify artist (query): Find an artist and see their top tracks.,spotify album (query): Search for an album and view its tracks.
,spotify preview (query): Play a 30-second preview of a track (if available).
Some tracks don't have preview clips available. Artist and album searches return the top result.
GitHub
Look up GitHub user profiles and repository information.
,github profile (username): View a user's bio, follower count, repositories, and contributions.,github 2email (username): Find public commit emails associated with a GitHub user.
,github repository (name): Look up a repository's description, stars, language, and topics.
Usernames are case-insensitive. The email lookup only finds addresses linked to public commits. Repositories require an exact or partial match of the name.
X (Twitter)
Look up X/Twitter profiles and fetch individual posts.
,x user (handle): Look up an X (Twitter) profile.,x post (url): Fetch an X (Twitter) post from its link.
X profile lookups display user bios, follower counts, and verified status (if applicable). To post an account's new posts automatically, see X Feeds.
Instagram Profiles
Instagram lookups work without any feed configuration and need no permissions.
,instagram user (username): Look up an Instagram profile (aliases:profile,u).,instagram posts (username): Show an account's recent posts (alias:recent).,instagram post (url): Repost an Instagram post from its link (aliases:p,repost).
League of Legends
,league profile (riotid): Look up a summoner's rank, matches and mastery (alias:summoner).,league champion (name): Look up a champion (alias:champ).,league rotation [region]: Show the current free champion rotation (alias:free).
Summoner lookups use Riot IDs: name#tag, not the old summoner name alone.
Bio Profiles
Look up user profiles from social bio platforms: guns.lol and haunt.gg.
,bio guns (query) [type]or,bio guns profile (query) [type]: Look up a guns.lol profile (search by username, alias, or UID). With no query it shows your own connected profile.,bio guns connect (username): Connect your own guns.lol account. greed looks the profile up and only connects it when that guns.lol profile has this Discord account linked, so link Discord on guns.lol first. You can also connect from the dashboard under Settings → Connections.,bio guns disconnect: Disconnect your guns.lol account.- A connected guns.lol account appears on your
,userinfocard after Last.fm and haunt.gg. Each guns.lol account can be connected to one Discord account, and if you later unlink Discord on guns.lol, greed disconnects it the next time that profile is looked up.
,bio haunt (query) [type]or,bio haunt profile (query) [type]: Look up a haunt.gg profile (search by username or UID).,bio haunt connect: Connect your own haunt.gg account. greed sends you a private sign-in link that works once and expires after 10 minutes. You can also connect from the dashboard under Settings → Connections.,bio haunt disconnect: Disconnect your haunt.gg account.- A connected haunt.gg account appears on your
,userinfocard next to Last.fm. Each haunt.gg account can be connected to one Discord account. ,bio leaderboard [type]: View the haunt.gg leaderboard (views, badges, or UID).
Profiles display custom bios, social links, page views, and verification status. The leaderboard updates periodically.
Fortnite
View Fortnite cosmetics, news, and map information.
,fortnite map: View the current Fortnite Battle Royale map with POI markers.,fortnite news: Get the latest Fortnite patch notes and news.
,fortnite view (cosmetic): Search for a cosmetic item (skin, emote, wrap, etc.) and view its details.
Cosmetic lookups may return multiple results; refine your search if needed. News updates with each patch cycle.
Last.fm Integration
Link your Last.fm account to get Spotify and YouTube links for currently playing tracks.
,lastfm spotify [user]: Get a Spotify link for your current track.,lastfm youtube [user]: Get a YouTube link for your current track.
,lastfm discoverydate [artist] [user]: Check when you first scrobbled an artist.
Requires a Last.fm account linked to your Discord profile. If omitted, uses your Last.fm username from Discord.
Troubleshooting
Feed channels deleted: If a feed's target channel is deleted, the feed stops posting and greed removes it. Set it up again with ,<platform> add pointing at a channel that still exists.
Creator not found: Ensure the username is spelled correctly and the account is public. Some very new accounts may not be indexed yet.
Profile lookups return no data: This may indicate the account is private, banned, or the username is misspelled. Try searching with different query formats.
Rate limits: Frequent lookups of the same profile may trigger temporary rate limiting. Space out requests if you're bulk-checking multiple profiles.