telegram-fileshare

Telegram Bot that automatically downloads the files you send

• english
• deutsch

deutsch

Inhalt

• Beschreibung
  • Version 1.1.1
  • Version 1.1.0
  • Version 1.0.0
• Einrichtung
• Fehlercodes

Beschreibung

Erstellen Sie Ihren ganz eigenen Telegram-Bot. Sie und Ihre Freunde können diesem einfach die Dateien als Nachricht schicken und der Bot lädt diese automatisch auf den Computer herunter. Treffen Sie verschiedene Einstellungen, um den Bot sicherer zu machen und Die können ihn ganz nach Ihren Vorstellungen nutzen.

neu in Version 1.1.1

• Benutzerdefinierte Dateinamen

neu in Version 1.1.0

• Es kann eine maximale Dateigröße vom Benutzer festgelegt werden
• Es kann ein Ordner ausgewählt werden, in dem die Dateien gespeichert werden sollen
• bug fixed:
  • Dateiendung in Groß- und Kleinschreibung werden erkannt

in Version 1.0.0

• Benutzerdefiniertes Passwort, das vor dem Nutzen eigegeben werden muss
• Liste an unterstützten Dateiendungen

Einrichtung

1. Laden Sie sich Node.js herunter
2. Laden Sie sich die Datei fileshare_x_x_x.js herunter
3. Öffnen Sie die Konsole (cmd.exe) und betreten Sie den Ordner, in welchem die Datei gespeichert ist
4. Laden Sie sich die "telegram-bot-api" herunter, indem Sie npm install telegram-bot-api in die Konsole eingeben
5. Erstellen Sie einen Telegram-Bot
   1. Öffnen Sie den Chat mit @BotFather
   2. Geben Sie /newbot ein
   3. Geben Sie nun einen Namen und einen Nutzernamen für den Bot ein
   4. Nun erhalten Sie den Token für den Bot. Dieser wird für die Kommunikation benötigt
   5. Geben Sie /setjoingroups ein
   6. Setzen Sie den Wert auf Disable
   7. Geben Sie weitere Informationen ein, um den Bot anzupassen: /setdescription /setabouttext /setuserpic
6. Erstellen Sie einen Ordner, in welchem die Dateien gespeichert werden sollen
7. Konfigurieren Sie Ihren Bot mithilfe der config.json Datei
   • Manuell über einen Editor
     1. Öffnen Sie die config.json Datei mit einem Editor und fügen Sie den Token ein, den Ihnen der @BotFather geschickt hat
     2. Legen Sie ein Passwort fest
     3. Passen Sie die Liste der unterstützten Dateiformate an
     4. Legen Sie eine maximale Dateigröße fest (Telegram unterstützt nur Dateien bis 20 MB)
     5. Geben Sie den Pfad des Ordners an, den Sie gerade erstellt haben
8. Starten Sie das Programm, indem Sie node fileshare_x_x_x.js eingeben

Fehlercodes

T

Fehler beim Herunterladen der Datei

• T1: HTTP-Statuscode (Die Datei konnte nicht heruntergeladen werden)
• T2: content-type (Die Datei konnte nicht heruntergeladen werden)
• T3: Dateiinformationen (Fehler beim Laden der Dateiinformationen vom Telegarm-Server)

F

Die Datei entspricht nicht den Anforderungen des Bots

• F1: Dateiformat (Das Dateiformat, i.d.F. die Dateiendung, ist nicht in der Liste der erlaubten Dateiendungen enthalten)
• F2: Dateigröße (Die Datei ist größer als die in der config.json festgelegte Größe oder überschreitet die von Telegram vorgegebenen 20 MB)
• F3: Dateiname (Eine Datei mit dem Namen existiert schon. Wählen Sie einen anderen Dateinamen)

C

Fehler beim öffnen oder schließen der Konfigurationsdatei (config.json)

• C1: open config (Fehler beim Öffnen der config.json Datei)
• C2: write config (Fehler beim Speichern der Änderung in der config.json Datei)

A

Fehler bei der Authentifizierung des Nutzers

• A1: Authentifizierung (Das eingegebene Passwort ist falsch)

english

content

• description
  • version 1.1.1
  • version 1.1.0
  • version 1.0.0
• setup
• error code

description

Create your very own Telegram bot. You and your friends can easily send files and the bot downloads them for you. You can configure the bot as you wish.

new in version 1.1.1

• user defined file names

new in version 1.1.0

• the user can set the maximal file size
• the user can specify a folder where the file will be stored
• bug fixed:
  • file extension can be in capital and lowercase letters

new in version 1.0.0

• custom password
• list of supported file extensions

setup

1. download and install Node.js
2. download the file: fileshare_x_x_x.js
3. open the command shell (cmd.exe) and open the folder where the file fileshare_x_x_x.js is located
4. download the 'telegram-bot-api' by entering the command npm i telegram-bot-api
5. create a Telegram bot
   1. open the chat with @BotFather
   2. type /newbot
   3. specify a name and a username for the bot
   4. you will receive a token for the bot
   5. type /setjoingroups
   6. set the value to Disable
   7. you can save more informations about the bot: /setdescription, /setabouttext, /setuserpic
6. create a folder where the files should be saved
7. configure the bot by editing the config.json file
   • manualy with an editor
     1. open the config.json file and add the token from @BotFather
     2. set a password
     3. customize the list of supported file extensions
     4. set maximal file size (Telegram only support files up to 20 MB)
     5. set the path to the destination of the folder you just have created
8. start the bot by typing node fileshare_x_x_x.js into the command shell

error codes

T

An error occured during the download

• T1: http-status-codes (unable to download the file)
• T2: content-type (unable to download the file)
• T3: file informations (error during the fetching process)

F

The file does not match the bots requirements

• F1: file format (the file extension does not match the file extension list)
• F2: file size (file exceeds the maximal file size, the maximum is 20 MB)
• F3: file name (file already exists)

C

An error occured during the configuation process

• C1: open config (cannot open config.json)
• C2: write config (error during the saving process)

A

An error occured during the authentification process

• A1: wrong password