emoji-downloader

Do you ever thought: "Oh, this instance have nice emoji's, I want them too."? Then just use this script to download them.

Inspired by emoji-stealer

Note: I'm still learning, so if you find weird stuff in my code, please inform me about it and/or tell me how I can inprove it. I'm happy about any input :)

Dependencies

lua (>=5.1)
lua-requests

Note: I removed the dependency luafilesystem for because I only used the lfs.mkdir() function from it, which lacks an option for recursive folder creation. First I thought to use another library, called lpath, which has a makedirs() function to create folders recursive, but it seems like the library is missing functions depending on the operation system, like I issued here: starwing/lpath#9
So I use os.execute('mkdir -p' .. path) now, to create the folder, but this only work with Linux. Maybe I get a good answer to my issue at lpath or I'll write a custom function to use lfs.mkdir() again in the future.

Install

The easiest way to install this script is to install it directly with luarocks like this:

luarocks install https://raw.githubusercontent.com/imolein/emoji-downloader/master/emoji-downloader-scm-0.rockspec

But you can also clone this git, install the dependencies listed above using luarocks and run the script directly.

luarocks install lua-requests

Usage

If installed directly with luarocks use it like this:

emoji-downloader: emoji-downloader [OPTIONS] URL
Download custom emoji's from a Pleroma or Mastodon instance.

Useable options:
  -d FOLDER      Define the folder where the downloaded emoji's are stored (default: /tmp)
  -ap API PATH   Define the custom emoji api path (defaul: /api/v1/custom_emojis)
  -et            Generates the emoji.txt which is needed for Pleroma
  -h             Shows this message
  -v             Verbose - shows a message per downloaded emoji

If you cloned this repository and installed only the dependencies with luarocks, you can use it the same way as described above, but with .lua file extension at the end:

lua emoji-downloader.lua "https://example.com"

Works with

TODO