Skip to content
forked from alemonmk/pytgasu

Automatic Telegram sticker uploader in Python3

License

Notifications You must be signed in to change notification settings

mariotaku/pytgasu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyTgASU

Telegram sticker sets creation automated (partially).

Features

PyTgASU frees you from selecting files and emojis repeatedly when creating sticker sets on Telegram.

Better yet, it makes sticker sets kind of "distributable" and "installable".

Motivation

There does is a Telegram Stickers Uploader, but:

  1. It has limited choices of emojis
    • Well, 250. Really? This is not enough. UTR #51 4.0 defined 910 code points with Emoji_Presentation=Yes.
  2. It does not work with current Telegram Desktop
    • It does send commands through it, but it cannot upload anything. At least not for me.

And now you have this.

Installation

Requirement

  • Python >= 3.5

Dependency

Use pip to install:

$ pip install pytgasu

or

$ git clone https://github.com/alemonmk/pytgasu.git
$ cd pytgasu
$ pip install .

Usage

Generate set definition

You need set definition file for each sticker set you want to create.

Generate definition files by running and enter some detail:

$ pytgasu defgen <dir>...

Then open the generate .ssd file with text editor of your choice to assign emojis (and only emojis).

Upload sticker sets

Once you are done editing the .ssd file(s), you can let pytgasu do the heavy lifting.

$ pytgasu upload (<dir>|<path_to.ssd>)...

By specifying upload -s, it also automatically subscribe to the set once it's uploaded.

You have to log in to Telegram at the first run, it won't ask you again after that. A Telegram session file will be created at ~/.pytgasu/asu.session.

Limitions & TODOs

  1. It does not help scale up/down if image is not appropriate size.
    • I can bundle waifu2x-caffe, but that would be a Windows-only feature.
  2. It does not help sink image file size if it is too large.
    • I will bundle pngquant.
  3. No way to log out.
    • Add a logout command. Meanwhile you can delete ~/.pytgasu/ and kill the session from other app.
  4. No GUI.
    • Well...I hope you are crazy enough to make one for me ;)

Contributing

Please create feature requests, leave suggestions through GitHub issue, or just code and fire a pull request.

It's okay to talk via e-mail if you want to stay private or just don't bother with GitHub.

Stuff in need

  • Tests. Preferably something nose uses.
  • Better documents. There's not much to document though ...
  • Feature requests. Keep it simple, don't complicate this tool.
  • Debug. I'm not that exhaustive and may leave edge cases here and there.

Author

(c) 2017 Lemon Lam <'%s@%s' % ('almk', 'rmntn.net')>

License

Licensed under GNU General Public License Version 3.

About

Automatic Telegram sticker uploader in Python3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%