Stickerify

Stiker

Bot Telegram untuk mengonversi media dalam format yang diperlukan untuk digunakan sebagai stiker Telegram

Daftar isi

• Cara menggunakan botnya
• Cara membuat stiker baru
• Cara menyiapkan proyek
• Cara menjalankan bot secara lokal
• Cara meluncurkan bot menggunakan Docker
• Bagaimana berkontribusi pada proyek ini
• Festival Hacktober
• Informasi yang berguna
• Kebijakan privasi
• Lisensi

Cara menggunakan botnya

Anda dapat menggunakan bot di sini: memulainya, dan sekarang Anda dapat mengirimkannya media yang perlu Anda konversi.

Berdasarkan apa yang Anda kirim, Stickerify akan menjawab hal berikut:

• media yang dikonversi, jika Anda mengirim file yang didukung (gambar, gif, video, dan stiker Telegram yang ada didukung) yang memerlukan konversi
• tidak ada file, jika Anda mengirimkan media yang sudah sesuai dengan kebutuhan Telegram
• pesan kesalahan, jika Anda mengirim file yang tidak didukung atau rusak
• pesan informatif untuk pesan apa pun tanpa file

 diagram alur LR
    A[Pengguna] -->|Pesan| B([Stiker])
    B -->|Permintaan berisi file| C{Apakah file didukung?}
    klik B "https://t.me/StickerifyImageBot" _blank
    isian gaya B: #2889ba, guratan: #e0e0e0, warna: #e0e0e0
    C -->|Ya| D{Apakah file memerlukan konversi?}
    C -->|Tidak| E (Pesan kesalahan)
    B -->|Permintaan hanya memiliki teks| F{Apakah perintah bantuan atau mulai?}
    F -->|Ya| G (Tampilkan penggunaan bot)
    F -->|Tidak| H (Tentang pesan)
    D -->|Ya| J (Konversi file)
    D -->|Tidak| K (Tidak ada konversi)

Cara membuat stiker baru

1. Ngobrol dengan Stiker, dan gunakan untuk membuat paket stiker
2. Minta Stiker untuk menambahkan stiker baru
3. Gunakan Stickerify untuk membuat file yang tepat untuk stiker Anda
4. Meneruskan pesan Stickerify ke Stiker
5. Pilih emoji yang mewakili stiker Anda

Dan selesai!

Cara menyiapkan proyek

1. Instal JDK 23 (atau lebih tinggi)
2. Kloning proyek dan pindahkan ke foldernya
3. Jalankan perintah ./gradlew build -x test
4. Impor proyek ke dalam IDE Anda sebagai proyek Gradle
5. Pastikan IDE Anda dikonfigurasi dengan benar untuk menggunakan JDK Java 23 (atau lebih tinggi).

Cara menjalankan bot secara lokal

Setelah Anda berhasil menyiapkan proyek, Anda harus melalui langkah-langkah berikut:

1. Ngobrol dengan Botfather dan minta untuk membuat bot baru
2. Salin token yang diberikan kepada Anda dan:
   • tetapkan sebagai nilai variabel lingkungan baru bernama STICKERIFY_TOKEN
   • gunakan itu sebagai nilai yang diteruskan ke konstruktor super(botToken) di dalam kelas Stickerify
3. Instal FFmpeg
4. Jalankan kelas Main untuk memulai bot, sekarang dapat menjawab pesan di Telegram

Cara meluncurkan bot menggunakan Docker

1. Instal Docker

2. Siapkan image Docker:

   • pindah ke folder proyek dan membuat image dengan perintah:

     docker build -t rob93c/stickerify .

   • menarik gambar dari Docker Hub:

     docker pull rob93c/stickerify

3. Sekarang Anda hanya perlu menjalankan image Docker dengan meneruskan token ( {{TOKEN}} ) yang diambil dari Botfather:

   docker run -e " STICKERIFY_TOKEN={{TOKEN}} " rob93c/stickerify

Bagaimana berkontribusi pada proyek ini

Lihatlah pedoman kontribusi proyek ini di sini.

Ada pertanyaan? Pertimbangkan untuk membuka diskusi baru.

Festival Hacktober

Hacktoberfest adalah acara yang bertujuan untuk mendorong orang berkontribusi pada proyek sumber terbuka setiap bulan Oktober. Proyek ini mematuhi inisiatif ini dan menyambut baik segala perbaikan terkait hacktoberfest!

Jika Anda ingin meningkatkan Stickerify sebagai bagian dari acara ini, pertama-tama bacalah pedoman berkontribusi dan kemudian pertimbangkan untuk membuka terbitan baru dan/atau permintaan penarikan.

Jika permintaan penarikan Anda mewakili kontribusi yang valid pada proyek, permintaan tersebut akan ditandai sebagai hacktoberfest-accepted , sehingga dihitung dalam sasaran 4 kontribusi.

Informasi yang berguna

• Bot dikerahkan di Kereta Api
• Dokumentasi resmi Telegram Bot API dapat ditemukan di sini
• Library yang digunakan bot untuk bekerja dengan Telegram adalah Java Telegram Bot API
• Konversi video menggunakan FFmpeg dan JAVE2
• Konversi gambar menggunakan Scriimage, ImageIO, dan TwelveMonkeys
• Validasi stiker animasi menggunakan Gson
• Analisis tipe MIME dilakukan menggunakan Apache Tika

Kebijakan Privasi

Kebijakan privasi dapat ditemukan di sini .

Lisensi

Lihat file LISENSI untuk hak dan batasan lisensi (MIT).