Minipostiz Reddit Setup

minipostiz-cli — Reddit Setup

Reddit uses OAuth2 password grant for script-type apps. You need app credentials + your account credentials + a target subreddit.

What you need

Step 1 — Create a Reddit App

1. Go to https://www.reddit.com/prefs/apps
2. Scroll down → click Create another app...
3. Fill in:
   • Name: minipostiz (or any name)
   • Type: select script (important — other types won't work with password grant)
   • Description: optional
   • Redirect URI: http://localhost (required, not used)
4. Click Create app
5. Note:
   • Client ID — the string under your app name (looks like abc123xyz)
   • Client Secret — shown as "secret" field

Step 2 — Check posting permissions

• Your Reddit account must have sufficient karma to post to most subreddits
• Some subreddits require account age minimums
• Test with a subreddit you own or moderate first (e.g. u_yourname — your profile subreddit)

Step 3 — Store in minipostiz-cli

minipostiz auth --platform reddit \
  --clientId "abc123xyz" \
  --clientSecret "YOUR_CLIENT_SECRET" \
  --username "your_reddit_username" \
  --password "your_reddit_password" \
  --subreddit "test"

# Or via supercli
sc minipostiz auth set-reddit \
  --clientId "abc123xyz" \
  --clientSecret "YOUR_CLIENT_SECRET" \
  --username "your_reddit_username" \
  --password "your_reddit_password" \
  --subreddit "test"

Use your own subreddit u_yourusername (profile posts) or a subreddit you own for testing.

Step 4 — Test

minipostiz auth verify --platform reddit
minipostiz publish --platform reddit --message "# Test Post

This is a test post via minipostiz-cli."

Post format

Reddit posts are self (text) posts. minipostiz-cli maps:

• First line → post title (markdown heading stripped)
• Remaining lines → post body (markdown supported)

minipostiz publish --platform reddit --message "# Post Title

Post body with **markdown** support."

Posting to different subreddits

The subreddit stored in auth is the default. To override:

# Store multiple reddit auth entries by adding extra credentials
# (minipostiz stores one per platform — change subreddit in auth to switch)
minipostiz auth --platform reddit --clientId ID --clientSecret S \
  --username U --password P --subreddit "anothersubreddit"

Troubleshooting

Token lifetime

Reddit password-grant tokens expire after 24 hours. minipostiz-cli re-authenticates automatically on each post using your stored credentials.

Security note

Storing your Reddit password in minipostiz-cli's SQLite DB (~/.minipostiz/minipostiz.db) is safe for personal use. For shared environments, use a dedicated alt account.