nirholas/lists-management

Lists Management

Browser console script for creating and managing X/Twitter lists.

Script Selection

| Goal | File | Navigate to | |------|------|-------------| | Create a new list | src/listManager.js | x.com/USERNAME/lists | | Add users to a list | src/listManager.js | List page | | Export list members | src/listManager.js | List members page |

List Manager

File: src/listManager.js

Browser console script that creates lists, adds members by username, and exports member data.

How to Use

1. Navigate to x.com/YOUR_USERNAME/lists (or an existing list page)
2. Open DevTools (F12) → Console
3. Edit the CONFIG section to enable desired operations
4. Paste the script → Enter

Configuration

const CONFIG = {
  createList: {
    enabled: false,
    name: 'My List',
    description: 'Created by XActions',
    isPrivate: true,
  },
  addUsers: {
    enabled: true,
    usernames: ['user1', 'user2'],
  },
  exportMembers: {
    enabled: false,
    maxMembers: 200,
  },
  actionDelay: 2000,
};

Create List

Sets createList.enabled: true to create a new list. Fills in the name, description, and privacy toggle, then saves.

Add Members

Sets addUsers.enabled: true with a list of usernames. Opens the add-member search, types each username, clicks the matching user cell, and repeats. Navigate to the target list page first.

Export Members

Sets exportMembers.enabled: true. Scrolls through the list members page and exports all members (username, display name, bio) as a JSON download.

DOM Selectors

| Element | Selector | |---------|----------| | Create list button | [data-testid="createList"] | | List name input | [data-testid="listNameInput"] | | List description | [data-testid="listDescriptionInput"] | | Private toggle | [data-testid="listPrivateToggle"] | | Save button | [data-testid="listSaveButton"] | | Add members | [data-testid="addMembers"] | | Search people | [data-testid="searchPeople"] | | User cell | [data-testid="UserCell"] |

Rate Limiting

• 2s delay between adding individual users
• 1.5s scroll delay when exporting members
• Up to 5 retries when no new members load during export scroll

X List Limits

• Maximum 1,000 lists per account
• Maximum 5,000 members per list
• Lists can be public (visible to anyone) or private (only you)

Troubleshooting

| Problem | Solution | |---------|----------| | Create button not found | Navigate to x.com/USERNAME/lists first | | User not found when adding | Verify username spelling; user may have changed handle | | Export stops early | Page may have finished scrolling; increase maxMembers if needed | | Search input not found | Ensure you clicked "Add member" — script expects the search overlay |