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

Credential	Flag
Client ID	--clientId
Client Secret	--clientSecret
Reddit Username	--username
Reddit Password	--password
Target Subreddit	--subreddit

---

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

Error	Cause	Fix
invalid_grant	Wrong username/password, or 2FA enabled	Disable 2FA or use password without special chars
403 Forbidden	Subreddit posting restricted	Try your profile subreddit u_yourusername
RATELIMIT	Too many requests	Reddit limits to ~1 post per 10 minutes
SUBREDDIT_NOTALLOWED	Account karma/age too low	Post to your own subreddit first
invalid_client	Wrong app type	Ensure app type is script, not web/installed

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.