naoTimes

versi 3.0.0
Bot berbahasa Indonesia untuk membantu tracking garapan fansubber.

Semua perintah memakai slash command (/)
Bantuan: /help

Invite • Requirements • Setup • Dokumentasi • Changelog

⚠ Laporkan kesalahan di Issues ⚠

Invite bot

Males setup sendiri? Mau simple dan cepet?

1. Invite bot dengan klik link ini: https://naoti.me/invite
2. Jika anda ingin menggunakan fitur Showtimes, silakan daftar di: https://panel.naoti.me/registrasi
3. Setelah itu bisa jalankan /showui untuk mendapatkan password.

Discord Gateway Intents

Agar naoTimes dapat bekerja dengan benar, anda membutuhkan Privileged Intents ini aktif di laman Discord Developer Portal.

• Server Members Intent Dibutuhkan agar beberapa fitur moderasi dan Showtimes dapat bekerja.
• Presence Intent Dibutuhkan agar fitur seperti user info dan server info dapat bekerja dengan benar dan akurat.

Requirements

• Python 3.8+
• Redis server
• MongoDB server (Bisa host di Atlas, ini untuk Showtimes)
• Discord Bot Token
• libmagic1

Untuk module, refer ke file pyproject.toml

Setting up

1. Install Python 3.8, siapkan redis server anda dan jalankan (silakan cari di Google)
   • Jika anda ingin menggunakan Showtimes, mohon siapkan MongoDB database.
2. Install uv lalu jalankan uv sync --no-dev (otomatis membuat virtualenv Python 3.13)
3. Install libmagic
   • Windows: Harusnya sudah terinstall ketika menggunakan pip install
   • Windows alt: Install dengan pip: pip install python-magic-bin
   • Debian/Ubuntu: sudo apt-get install libmagic1
   • OSX/macOS: brew install libmagic atau port install file
4. Buat config baru mengikuti config.json.example
   • Jika anda tidak punya, bisa diabaikan aja.
   • Silakan refer ke Konfigurasi
5. Jalankan bot dengan uv run python bot.py
6. Invite bot dengan permission berikut:
   • Manage Server
   • Manage Channels
   • Manage Roles
   • Kick Members
   • Ban Members
   • Manage Nicknames
   • Change Nickname
   • Manage Emojis and Stickers
   • View Audit Log
   • Read Messages
   • Send Messages
   • Manage Messages
   • Embed Links
   • Attach Files
   • Read Messages History
   • Mention @eveyone, @here, and All Roles
   • Add Reactions
   • Use External Emojis
   • Mute Members
   • Deafen Members
7. naoTimes sudah siap, anda bisa mengaktifkan fitur opsional

Untuk menjalankan naoTimes di mode production, mohon buat file kosong dengan nama authorize_prod di folder utama.

Atau jalankan bot di dev mode dengan menambahkan argumen -dev setelah python bot.py

(env) $ python bot.py -dev

Konfigurasi

Berikut adalah contoh konfigurasi naoTimes:

{
    "bot_id": "",
    "bot_token": "",
    "default_prefix": "!",
    "dev_mode": false,
    "slash_test_guild": null,
    "vndb": {
        "token": ""
    },
    "mongodb": {
        "ip_hostname": "localhost",
        "port": 27017,
        "dbname": "naotimesdb",
        "tls": false,
        "auth": ""
    },
    "redisdb": {
        "ip_hostname": "127.0.0.1",
        "port": 6379,
        "password": null,
        "db": 0
    },
    "socketserver": {
        "enabled": true,
        "port": 25670,
        "password": null
    },
    "kbbi": {
        "email": "",
        "password": ""
    },
    "fansubdb": {
        "username": "",
        "password": ""
    },
    "weather_data": {
        "openweatherapi": "",
        "opencageapi": ""
    },
    "wolfram": {
        "app_id": ""
    },
    "merriam_webster": {
        "dictionary": "",
        "thesaurus": ""
    }
}

• bot_id merupakan "Client ID" aplikasi anda, dapat diliat dibagian OAuth2
• bot_token merupakan token yang anda buat di bagian Bot
• default_prefix sudah tidak dipakai (semua perintah sekarang slash command), tetapi key ini masih harus ada di config
• dev_mode aktifkan mode development (database _dev, hot-reload cogs, tidak butuh file authorize_prod), bisa juga lewat flag -dev.
• slash_test_guild sebuah server sebagai test guild untuk /slash command, ini akan mastiin semua /slash command bisa bekerja!
• vndb.token merupakan token API VNDB opsional. Buat token dari halaman Applications di profil VNDB. Fitur pencarian tetap bisa digunakan tanpa token.
• mongodb merupakan konfigurasi MongoDB, jika anda tidak ingin menggunakannya mohon hapus
  • ip_hostname merupakan IP/domain database anda
  • port merupakan port yang dipakai untuk database anda (default 27017)
  • dbname nama databasenya, contoh naotimes
  • tls jika anda menggunakan SSL, jika host di MongoDB Atlas, ubah jadi true
  • auth merupakan username/password untuk akses database anda (bisa dikosongkan), formatnya adalah: username:password
• redisdb merupakan konfigurasi Redis anda
  • ip_hostname merupakan IP/domain database redis anda
  • port merupakan port yang dipakai untuk database anda (default 6379)
  • password password untuk akses redis anda (bisa dikosongkan)
  • db nomor database Redis yang dipakai (default 0), berguna jika Redis dipakai bersama aplikasi lain atau untuk memisahkan dev/prod
• socketserver merupakan socket server di mana anda bisa menggunakannya untuk akses bot dengan menggunakan socket (bukan websocket)
  • enabled set ke false (atau "socketserver": null) untuk mematikan socket server (default: true)
  • port port untuk run socket servernya (default: 25670)
  • password jika anda butuh password untuk akses
• fansubdb fitur integrasi Showtimes dengan FansubDB (bisa dikosongkan)
• weather_data API key untuk fitur cuaca naoTimes, bisa dikosongkan
  • openweatherapi API key OpenWeatherMap (https://openweathermap.org/)
  • opencageapi API key untuk OpenCage Geocoding (https://opencagedata.com/)
• wolfram App ID untuk fitur Wolfram, bisa dikosongkan jika tidak butuh
• merriam_webster API key untuk fitur definisi kata dan tesaurus kata bahasa inggris melalui Merriam Webster, disarankan pilih yang Collegiate (bisa dikosongkan)
  • dictionary API key untuk akses Collegiate dictionary
  • thesaurus API key untuk akses Collegiate thesaurus

Fitur opsional

naoTimes juga ada fitur opsional yang bisa diaktifkan ketikan bot sudah aktif.

1. Error logging Fitur di mana anda bisa log masalah bot ke sebuah server, jika tidak ada akan dikirim ke DM anda. Aktifkan dengan menambah opsi error_logger ke config.json anda dengan isi channel ID-nya. Contoh:

[...]
    "error_logger": 12345678090123
[...]

3. Sentry Logging Fitur di mana anda dapat mengupload semua log masalah anda ke Sentry. Untuk menggunakannya cukup tambahkan config ini ke file config.json anda.

[...]
    "statistics": {
        "sentry_dsn": "https://1234567890abcdefghijklmn.ingest.sentry.io/XXXXXX"
    }
[...]

Silakan ganti sentry_dsn sesuai DSN anda.

Donasi

Anda dapat mensupport naoTimes dan mendapatkan fitur Premium. Dengan donasi mulai dari 1$ atau 15000, anda dapat mengakses fitur premium berikut.

1. FansubRSS Premium
   • 3 RSS
   • Rate refresh lebih cepat (2 menit dibanding 5 menit)
2. Premium support

Silakan donasi ke link berikut:

• Trakteer (Indonesia) [IDR]
• Ko-fi (Lain-lain) [USD]

Kontribusi Translasi

naoTimes mulai support dua bahasa mulai dari versi 3.1.0, untuk membantu proses translasi di mohon untuk bergabung ke project Crowdin kami di sini: https://crowdin.com/project/naotimes

Di mohon untuk mengikuti penulisan format, jika ada yang di {kurung} seperti ini mohon ikuti dengan isinya dan jangan ditranslasikan.

Lisensi

naoTimes dilisensi dengan lisensi MIT. Logo yang dipakai oleh naoTimes merupakan karakter Hitori Bocchi dari anime Hitori Bocchi no Marumaru Seikatsu, logo tersebut merupakan hak cipta pembuatnya.