madebydia/xqueue

O que xqueue faz?

Agendador de posts para X/Twitter baseado em arquivos. Seu sistema de arquivos é a interface.

Visão Geral

madebydia/xqueue permite agendar posts para X/Twitter gerenciando arquivos de texto em um diretório local. Cada arquivo corresponde a um post, e o conteúdo define o que será publicado. A estrutura de diretórios é usada para controle de tempo e estado.

Como Funciona

1. Crie um diretório para o agendador (ex.: ~/xqueue).
2. Adicione arquivos de texto com o conteúdo do post. O nome do arquivo pode incluir um timestamp para agendamento (ex.: 2024-01-01-12-00.txt).
3. O agendador monitora o diretório e publica os posts nos horários especificados.
4. Após a publicação, o arquivo é movido para uma subpasta published (ou excluído, conforme configuração).

Pré-requisitos

• Node.js 18+ ou Python 3.8+
• Acesso à API do X/Twitter (credenciais necessárias)

Instalação

# Usando Node.js
npm install -g xqueue

# Usando Python
pip install xqueue

Configuração

Defina as seguintes variáveis de ambiente:

• XQUEUE_DIR: Caminho para o diretório monitorado (padrão: ./xqueue)
• XQUEUE_CONSUMER_KEY: Chave de consumidor da API do X
• XQUEUE_CONSUMER_SECRET: Segredo do consumidor da API do X
• XQUEUE_ACCESS_TOKEN: Token de acesso
• XQUEUE_ACCESS_TOKEN_SECRET: Segredo do token de acesso

Uso

1. Inicie o agendador:

xqueue start

2. Crie um post:

echo "Meu primeiro post agendado!" > ~/xqueue/2024-01-01-12-00.txt

3. O agendador publicará automaticamente em 2024-01-01 às 12:00.

Estrutura de Diretórios

xqueue/
├── pending/          # Posts aguardando publicação
│   ├── 2024-01-01-12-00.txt
│   └── 2024-01-02-15-30.txt
├── published/        # Posts já publicados
└── failed/           # Posts com falha

Configuração Adicional

• Formato de timestamp: YYYY-MM-DD-HH-MM (fuso horário local)
• Suporte a threads: nomeie arquivos sequencialmente (ex.: thread-1.txt, thread-2.txt)
• Arquivos sem timestamp são publicados imediatamente.

Limitações

• Máximo de 300 posts por dia (limite da API do X).
• Apenas texto simples; mídia não é suportada.

Suporte

Para dúvidas ou problemas, consulte a documentação oficial.