Skip to content

Quick Start Guide

Get FenLiu up and running in 5 minutes!

1. Start the Server (1 min)

fenliu --reload

Visit http://localhost:8000 in your browser.

2. Add Your First Stream (1 min)

  1. Click Streams in the navigation
  2. Click Create New Stream
  3. Enter a hashtag (e.g., python)
  4. Select your instance (default: mastodon.social)
  5. Click Create

3. Fetch Posts (1 min)

  1. Click Fetch All to retrieve posts for your stream
  2. Watch the progress modal update
  3. Posts will appear in your database

4. Review Posts (1 min)

  1. Click Review to open the review interface
  2. See posts with spam scores
  3. Click Approve ✓ or Reject ✗ on posts
  4. Optionally adjust the spam score slider

5. Export to Curated Queue (1 min)

  1. Click Queue to view the export queue
  2. See approved posts ready for export
  3. Monitor delivery status
  4. Use Previous/Next buttons to browse images

Key Concepts

Spam Score (0-100)

  • 0-30: Likely legitimate content
  • 30-70: Questionable - requires manual review
  • 70-100: Likely spam

Post States

  • 🟢 Approved: Ready to export to Curated Queue
  • 🔴 Rejected: Will not be exported
  • ⚪ Pending: Awaiting review decision

Queue States

  • 🟨 Pending: Waiting to be processed
  • 🔵 Reserved: Currently being processed
  • 🟢 Delivered: Successfully exported
  • 🔴 Error: Failed to export

Settings

Click Settings to configure:

  • Attachments-Only Export: Only export posts with media
  • Auto-Reject Blocked Posts: Auto-reject blocked users/hashtags
  • Don't Reblog Users: Block specific accounts
  • Don't Reblog Hashtags: Exclude posts with certain hashtags

Next Steps