nirholas/xactions/direct-messages

Direct Messages

Browser console scripts for sending, managing, and exporting X/Twitter DMs.

Available Scripts

Send Direct Messages

File: src/sendDirectMessage.js

Send personalized DMs to multiple users with message templates and rate limiting.

Configuration

const CONFIG = {
  targetUsers: ['user1', 'user2'],
  messageTemplate: 'Hey {username}! 👋 Just wanted to connect.',
  limits: {
    messagesPerSession: 10,
    delayBetweenMessages: 30000,
  },
  skipIfAlreadyMessaged: true,
  dryRun: true,
};

How to use

1. Navigate to x.com/messages
2. Edit CONFIG with target users and message template
3. Set dryRun: false when ready
4. Open DevTools (F12) → Console
5. Paste the script → Enter

Safety features

• Tracks sent messages in localStorage to avoid duplicates
• Configurable delay between messages (30s default)
• Session limit prevents over-messaging
• Dry-run mode previews actions without sending

Warning: Mass DMing can get your account restricted. Only message users who have open DMs or follow you.

DM Manager

File: src/dmManager.js

Core module for reading, filtering, organizing, and exporting DM conversations. Supports message requests, conversation search, and DM privacy settings.

How to use

1. Navigate to x.com/messages
2. Open DevTools (F12) → Console
3. Paste the script → Enter

Key Selectors

Notes

• DM scripts require being on the Messages page (x.com/messages)
• Group chats support up to 50 participants
• Message requests from non-followers must be approved before replying
• Add delays (30s+) between bulk DMs to avoid rate limits
• {username} placeholder in templates is replaced with the recipient's handle
• Sent history is persisted in localStorage across sessions