Skip to main content
Sessions are the core feature of JOIP - multimedia slideshows that combine images, videos, and AI-generated captions for an interactive viewing experience.

Session Types

JOIP supports three types of sessions, each with different creation workflows:

Reddit Sessions

AI-powered sessions using content from your favorite subreddits with automatically generated captions

Custom Sessions

Upload your own images and write custom captions for complete creative control

Imported Sessions

Import existing JOIP galleries from Imgchest with preserved order and captions

Creating a Reddit Session

Reddit sessions automatically fetch media from subreddits and generate AI captions based on your chosen theme.
1

Navigate to Sessions

From the sidebar, click Sessions to open your sessions library.
2

Choose Session Type

Click the Create Session dropdown button and select AI Generated Session.
This option uses Reddit content with AI-generated captions based on your selected theme.
3

Configure Session Details

Fill in the basic information:
  • Title: Give your session a descriptive name
  • Subreddits: Enter one or more subreddit names (e.g., celebs, goddess, nsfw)
    • The system validates subreddits and removes invalid entries
    • URLs and r/ prefixes are automatically cleaned
  • Category (optional): Organize your session into a category
4

Select Caption Theme

Choose an AI caption style from the available themes:
  • JOI / Edging: Mommy/Goddess stroke commands with edge counts and denial
  • Forced-Bi: Manipulation and rationalization themes
  • Bully / Simp: Mean girl energy and out-of-league scenarios
  • Pain / CBT: Specific physical command themes
  • Cuckold: Bull and size comparison scenarios
  • Custom Prompt: Write your own AI instructions
If you select “Custom Prompt”, you’ll need to provide detailed instructions for the AI caption generator.
5

Set Playback Speed

Use the Speed Range sliders to control timing:
  • Min Interval: Fastest slide duration (1-60 seconds)
  • Max Interval: Slowest slide duration (1-60 seconds)
The player will randomize timing between these values for variety.
6

Choose Transition Effect

Select how slides change:
  • Fade: Smooth crossfade (default)
  • Slide: Horizontal sliding motion
  • Zoom: Scale-in effect
  • Flip: 3D flip transition
  • None: Instant change with no animation
7

Upload Thumbnail (Optional)

Add a custom thumbnail or let the system auto-generate one from the first media item.
8

Set Privacy Options

  • Public: Makes your session visible in the community feed
  • Favorite: Pin to your favorites tab for quick access
  • Manual Mode: Disables auto-advance (requires manual navigation)
9

Create Session

Click Save Session. The system will:
  1. Validate your subreddits
  2. Create the session in your library
  3. Begin fetching media in the background (up to 100 items)
  4. Pre-generate captions for the first few slides
Session creation costs 25 credits for premium AI caption generation.

Creating a Custom Session

Custom sessions let you upload your own images and write personalized captions.
1

Start New Custom Session

Click Create SessionCustom Session from the Sessions page.
2

Add Media Files

Upload images using any of these methods:
  • Drag and drop files anywhere in the editor
  • Click Add Media to browse files
  • Paste from clipboard (Ctrl/Cmd+V)
  • Maximum 100 images per session
  • 100MB file size limit per image
  • Supported formats: JPEG, PNG, WebP (GIFs not supported for AI captions)
3

Write Captions

For each slide:
  • Click the caption text area
  • Write your caption (no character limit, but <500 recommended)
  • Use the AI magic wand button to generate contextual captions
AI captions consider surrounding slides for narrative continuity.
4

Organize Slides

  • Drag and drop slides to reorder (use the large grab handle)
  • Duplicate slides using the copy button
  • Replace media by clicking the image overlay
  • Delete slides using the trash icon
5

Configure Session Settings

Set title, timing, transitions, and privacy options (same as Reddit sessions).
6

Validate and Save

The system checks:
  • All slides have images attached
  • Captions are within recommended length
Click Save Session to create your custom session.

Importing from Imgchest

Import existing JOIP galleries with preserved captions and ordering.
1

Get Imgchest URL

Copy the full URL of an Imgchest gallery (e.g., https://imgchest.com/p/abc123)
2

Start Import

Click Create SessionImport JOIP from the Sessions page.
3

Paste URL and Import

  • Paste the Imgchest URL
  • Click Import
  • Wait for the system to fetch all images and captions
4

Review Imported Content

The session opens in the Manual Session Editor where you can:
  • Edit captions
  • Reorder slides
  • Replace images
  • Adjust settings
Imported sessions are treated as manual sessions and can be fully edited like custom sessions.

Playing Sessions

Once created, sessions can be played with an interactive media player.
From your Sessions library:
  1. Find your session in the grid
  2. Click the Play button
  3. The session opens in fullscreen player mode
Or use the quick-play button directly from session cards.

Managing Sessions

Sessions Library

Your Sessions page has three tabs:
  • All Sessions: Complete library with search
  • Favorites: Sessions marked as favorites
  • Shared: Sessions you’ve shared with others
Search and Filter
  • Search by title or subreddit
  • Filter by category
  • Sort by date created or name

Session Actions

Edit

  • Reddit sessions: Modify subreddits, theme, timing, settings
  • Custom/Imported: Full slide editor with caption editing
  • Auto-routes to appropriate editor based on session type

Share

  • Generate unique share code (UUID-based)
  • Toggle public/private access
  • Copy shareable link: /shared/{shareCode}
  • Shared sessions have public preview pages

Refresh Media

  • Reddit sessions only
  • Fetches new media from subreddits
  • Replaces old content with fresh posts

Delete

  • Permanently removes session and all media
  • For manual sessions: Deletes entire storage folder
  • Cannot be undone

Session Badges

Sessions display visual badges indicating their type:
  • Subreddit Badges (blue): Reddit-based sessions show source subreddit
  • Custom Session (purple): Manually created with uploads
  • Imported (gray): Imported from Imgchest
  • AI Generated (gold): Reddit session with AI captions

Best Practices

  • Use 2-5 subreddits for variety without dilution
  • Mix popular and niche subreddits
  • Test subreddit validity before creating (system auto-validates)
  • Remove banned or invalid subreddits when prompted
  • Match theme to subreddit content for best results
  • Custom prompts need detailed instructions (100-500 characters)
  • Test different themes on the same content for variety
  • Use 3-10 seconds for fast-paced sessions
  • Use 5-15 seconds for story-driven content
  • Set wider ranges (3-30) for unpredictability
  • Manual mode gives complete control (disable auto-advance)
  • Keep captions under 500 characters for readability
  • Use AI generation for consistency in tone
  • Build narrative flow across slides
  • Test playback to ensure caption timing works

Troubleshooting

Check these common issues:
  • Invalid subreddit names (must exist and be accessible)
  • Empty subreddit list after validation
  • Insufficient credits (25 required for session creation)
  • File size exceeds 100MB (custom sessions)
  • Too many files (max 100 images)
  • Captions generate on-demand (may take 2-3 seconds)
  • Check for API key errors in session settings
  • Verify internet connection for AI caption requests
  • Try regenerating caption with the refresh button
  • Verify URL is correct and accessible
  • Check that gallery is public (not private)
  • Ensure Imgchest API key is configured
  • Try again if network timeout occurred
  • For Reddit: Media URLs may have expired (refresh media)
  • For Custom: Files may not have uploaded (check file size)
  • For Imported: Source images may be deleted from Imgchest

Build docs developers (and LLMs) love