Quick Start

Get started with Chronosky in 5 minutes! This guide will walk you through creating your first scheduled post.

Prerequisites

Before you begin, make sure you have:

• A Bluesky account
• Access to the Chronosky web app at chronosky.app

Step 1: Sign In with Bluesky

1. Visit chronosky.app
2. Click the login button in the top-right to go to the login screen
3. Click the "Sign in with Bluesky" button
4. Enter your Bluesky handle (e.g., username.bsky.social)
5. Authorize Chronosky to access your account

INFO

🛡️ Secure Authentication Chronosky uses Bluesky's official authentication method for secure authentication. Your Bluesky password is never shared with Chronosky. All authentication happens directly with Bluesky.

Step 2: Authorize Scheduler Access

After signing in, you'll be prompted to authorize the scheduler:

1. Go to Settings → Scheduler
2. Click "Authorize Scheduler"

3. Complete the authentication process

WARNING

Why Two Authentication Steps? Chronosky uses different authentication:

• Web Authentication: For account login and browsing in your browser, creating scheduled posts
• Scheduler Authentication: For executing scheduled posts asynchronously

This separation ensures maximum security and allows you to revoke only the scheduler's permissions independently.

Step 3: Create Your First Post

Now you're ready to schedule a post!

Simple Text Post

1. Click the "New Post" button
2. Enter your post content:

Hello Bluesky! 🦋
This is my first scheduled post using Chronosky!

3. Select the date and time for the post

4. Click "Schedule Post"

TIP

Scheduling Times Posts must be scheduled at least 5 minutes in the future. The scheduler checks for pending posts every minute.

With an Image

1. Click "New Post"
2. Enter your post content
3. Click the image icon or drag & drop an image
4. Add alt text (optional but recommended for accessibility)
5. Select the scheduled time
6. Click "Schedule Post"

• Supported image formats: JPEG, PNG, WebP, GIF
• Maximum size: 2MB per image (Bluesky limit)
• Maximum images: 10 per post

Step 4: View Your Scheduled Posts

All your scheduled posts appear in the dashboard:

1. Pending: Posts waiting to be published
2. Published: Posts that have been successfully posted
3. Failed: Posts that encountered errors

Note: You can switch between a "List view" and a "Calendar view" to manage your schedule.

Click on any post to:

• View details
• Edit (before execution)
• Delete

Next Steps

Now that you've created your first scheduled post, explore more features:

Create a Thread

Learn how to schedule multi-post threads:

• Thread Posts Guide

Schedule Reposts & Deletions

Automatically repost your past posts, or automatically delete a post at a time you choose:

• Scheduled Reposts & Deletions Guide

Advanced Features

• Link Cards - Automatic link preview generation
• Hashtags & Mentions - Automatic parsing

Troubleshooting

Post Not Publishing

If your post doesn't publish at the scheduled time:

1. Check scheduler authorization: Settings → Scheduler

2. Check language settings: Settings → Language

3. Check error message: View post details for error information

Scheduler Token Expired

If you see "Scheduler token expired":

1. Go to Settings → Scheduler
2. Click "Revoke & Re-authorize"
3. Complete the OAuth flow again

WARNING

Token Expiration Scheduler tokens expire after 180 days. You'll receive a warning 7 days before expiration.

Need Help?

• Check FAQ for common questions
• Read the full Reference

Congratulations! 🎉

You've successfully created your first scheduled post with Chronosky. Explore more features and plan your content ahead of time!