🐘 Welcome Bot pro Mastodon

Tento bot slouží k automatickému zasílání uvítacích zpráv novým uživatelům na Mastodon instanci.

Vytvoření souborů s klientským klíčem a klientským secret

1. Přihlaste se na svůj server a přejděte do adresáře, kde máte svůj projekt.

2. Vytvořte soubor client_id.secret a vložte do něj klientský klíč:

echo "your_client_id" > client_id.secret

Nahraďte your_client_id skutečným klientským klíčem, který získáte při registraci aplikace na Mastodon instanci.

3. Vytvořte soubor secret_storage.secret a vložte do něj klientský secret:

echo "your_client_secret" > secret_storage.secret

Nahraďte your_client_secret skutečným klientským secret, který získáte při registraci aplikace na Mastodon instanci.

4. Přihlášení a získání přístupového tokenu:

Vytvořte soubor credential_storage.secret a vložte do něj přístupový token:

echo "your_credential_storage.secret> credential_storage.secret" > credential_storage.secret

Pokud ještě nemáte přístupový token, spusťte skript s vašimi přihlašovacími údaji:

python3 welcome_bot.py --email vas_email@example.com --password vase_heslo

Co udělat při dalším spuštění

Při dalším spuštění již nebudete muset zadávat přihlašovací údaje, protože token bude uložen v souboru credential_storage.secret:

python3 welcome_bot.py

Požadavky

• Python 3.12
• Knihovny: Mastodon.py, python-dotenv

Instalace

1. Naklonujte repozitář:

 git clone https://your-repo-url.git
 cd welcome_bot

2. Vytvořte virtuální prostředí a aktivujte ho:

python3 -m venv venv
source venv/bin/activate

3. Nainstalujte potřebné balíčky:

pip install -r requirements.txt

Vytvořte konfigurační soubory:

• config.toml:

[mastodon]
base_url = "url_instance_mastodon"
client_id = "client_id.secret"
secret_storage = "secret_storage.secret"
credential_storage = "credential_storage.secret"

[database]
sqlite_path = "welcome_bot.db"

[[messages]]
content = "Vítej na naší instanci Mastodon!"
content_warning = "Upozornění"

[[messages]]
content = "Jsme rádi, že jsi tady!"

[[messages]]
content = "Doufáme, že si užiješ pobyt na naší platformě!"

• client_id.secret: Vložte svůj client ID.

• secret_storage.secret: Vložte svůj client secret.

• credential_storage.secret: Vložte svůj access token.

Použití

1. Ujistěte se, že je aktivováno vaše virtuální prostředí:

source venv/bin/activate

2. Spusťte bota:

python3 welcome_bot.py

2. stěte se, že je aktivováno vaše virtuální prostředí:

source venv/bin/activate

Spusťte bota:

python3 welcome_bot.py

Příspěvky

Příspěvky jsou vítány! Pro více informací viz CONTRIBUTING.md

Licence

Tento projekt je licencován pod MIT licencí - viz LICENSE soubor pro detaily. Acknowledgements

Tento projekt je založen na isosphere/mastodon-welcome projektu. Děkujeme autorům za jejich skvělou práci.