King Userbot

Bu, Telegram için geliştirilmiş, çeşitli kullanışlı özelliklere sahip bir userbot'tur. Kendi Telegram hesabınız üzerinden çalışır ve komutlarla etkileşim kurar.

Özellikler

• Müzik ve Video İndirme: YouTube'dan müzik (MP3) ve video (MP4) indirebilir.
• Otomatik Yanıtlar: Belirli anahtar kelimelere otomatik yanıtlar ekleyebilir, listeleyebilir ve silebilirsiniz.
• Araçlar: Dolar kuru çevirici, hava durumu sorgulama ve günlük burç yorumları gibi araçlar içerir.
• Animasyonlar: Günaydın ve İyi Geceler animasyonları gönderir.
• Spam Kontrolü: Aşırı komut kullanımını engellemek için basit bir spam kontrol mekanizması bulunur.

Kurulum

Botu çalıştırmak için aşağıdaki adımları takip edin:

1. Gerekli Yazılımlar:

   • Python 3.8 veya üzeri yüklü olmalıdır.
   • pip (Python paket yöneticisi) yüklü olmalıdır.

2. Proje Dosyalarını İndirme: Bu GitHub deposunu bilgisayarınıza klonlayın veya ZIP olarak indirin.

   git clone https://github.com/king0din/kingtguserbot.git
   cd kingtguserbot

3. Gerekli Kütüphaneleri Yükleme: Proje dizininde requirements.txt dosyasında belirtilen tüm Python kütüphanelerini yükleyin:

   pip install -r requirements.txt

   Önemli: yt-dlp kütüphanesinin güncel olduğundan emin olun:

   pip install --upgrade yt-dlp

4. API Bilgilerini Alma: - Telegram API ID ve API Hash almak için my.telegram.org adresine gidin, giriş yapın ve yeni bir uygulama oluşturun.

   • Hava durumu özelliği için Weatherstack sitesinden ücretsiz bir API anahtarı alın.

5. Konfigürasyon: userbot.py dosyasını açın ve aşağıdaki değerleri kendi bilgilerinizle değiştirin:

   api_id = 'SIZIN_API_ID_NIZIZ'
   api_hash = 'SIZIN_API_HASH_INIZ'
   owner_id = SIZIN_KULLANICI_ID_NIZIZ  # Telegram kullanıcı ID'nizi buraya yazın
   weather_api_key = 'SIZIN_WEATHERSTACK_API_ANAHTARINIZ'

   Kullanıcı ID'nizi Öğrenme: Telegram'da @userinfobot botuna mesaj göndererek kullanıcı ID'nizi öğrenebilirsiniz.

Kullanım

1. Botu Başlatma: Proje dizininde terminal veya komut istemi açın ve şu komutu çalıştırın:

   python userbot.py

2. İlk Çalıştırma: Bot ilk kez çalıştırıldığında, Telegram telefon numaranızı girmenizi ve doğrulama kodunu girmenizi isteyecektir. Bu bilgiler güvenli bir şekilde saklanır ve bir sonraki çalıştırmada tekrar istenmez.

3. Komutları Kullanma: Bot çalıştıktan sonra, Telegram'da herhangi bir sohbette aşağıdaki komutları kullanabilirsiniz:

Komut Listesi

Müzik & Video

• .müzik <şarkı adı> - Belirtilen şarkıyı YouTube'dan MP3 olarak indirir ve gönderir.
• .video <video adı> - Belirtilen videoyu YouTube'dan MP4 olarak indirir ve gönderir.

Yanıt Yönetimi (Sadece Bot Sahibi)

• .yeniyanıt <anahtar> <yanıt> - Yeni otomatik yanıt ekler.
• .yanıtlarıgöster - Tüm kayıtlı otomatik yanıtları listeler.
• .yanıtsil <anahtar> - Belirtilen anahtarla kayıtlı yanıtı siler.
• .yanıtlarısil - Tüm otomatik yanıtları siler.

Araçlar

• .dolar <miktar> - Belirtilen dolar miktarını Türk Lirası'na çevirir.
• .havadurumu <şehir> - Belirtilen şehrin hava durumunu gösterir.
• .burç <burç adı> - Belirtilen burç için günlük yorum getirir.

Animasyonlar

• .gn - Günaydın animasyonu gönderir.
• .ig - İyi geceler animasyonu gönderir.

Yönetici Komutları (Sadece Bot Sahibi)

• .spam <kullanıcı_id> - Belirtilen kullanıcıyı spam listesine alır (12 saat).
• .unspam <kullanıcı_id> - Belirtilen kullanıcının spam engelini kaldırır.

Yardım

• .yardım - Tüm komutların listesini gösterir.

Güvenlik Notları

• Oturum Dosyaları: userbot_session/ klasörü hassas bilgiler içerir. Bu klasörü asla başkalarıyla paylaşmayın.
• API Anahtarları: API ID, API Hash ve diğer API anahtarlarınızı asla herkese açık yerlerde paylaşmayın.
• Userbot Kullanımı: Bu bot, kendi Telegram hesabınız üzerinden çalışır. Telegram'ın kullanım şartlarına uygun şekilde kullanın.

Sorun Giderme

Yaygın Hatalar

1. UnicodeEncodeError: Windows'ta Türkçe karakter sorunu yaşıyorsanız, botu şu şekilde çalıştırın:

   python -X utf8 userbot.py

2. yt-dlp Hataları: YouTube indirme sorunları yaşıyorsanız, yt-dlp'yi güncelleyin:

   pip install --upgrade yt-dlp

3. İzin Hataları: Bot, mesaj göndermeye çalıştığı gruplara üye olmalı ve yazma izni olmalıdır.

Destek

Herhangi bir sorun yaşarsanız veya öneriniz varsa, GitHub'da bir issue açabilirsiniz.

Lisans

Bu proje MIT lisansı altında yayınlanmıştır. Detaylar için LICENSE dosyasına bakın.

Katkıda Bulunma

Projeye katkıda bulunmak istiyorsanız:

1. Bu depoyu fork edin.
2. Yeni bir branch oluşturun (git checkout -b feature/yeni-ozellik).
3. Değişikliklerinizi commit edin (git commit -am 'Yeni özellik eklendi').
4. Branch'inizi push edin (git push origin feature/yeni-ozellik).
5. Bir Pull Request oluşturun.

Yasal Uyarı

Bu bot, eğitim ve kişisel kullanım amaçlıdır. YouTube'dan içerik indirirken telif hakkı yasalarına uygun davranın. İndirdiğiniz içeriklerin kullanım haklarına sahip olduğunuzdan emin olun.