git404hub

what is fedi-emoji-tool fr?

eternal-flame-ad/fedi-emoji-tool — explained in plain English

Analysis updated 2026-07-21 · repo last pushed 2024-09-28

6HaskellAudience · ops devopsComplexity · 3/5StaleSetup · moderate

tl;dr

A tool for Misskey community server admins that automatically discovers and downloads custom emoji from connected federated servers, filtering out licensed or rare emoji, then packages everything for direct import back into Misskey.

vibe map

mindmap
  root((repo))
    What it does
      Scans federated servers
      Filters licensed emoji
      Skips rare emoji
      Throttles downloads
    Tech stack
      Haskell
      Under 8GB RAM
      CLI tool
    Use cases
      Build emoji library
      Update over time
      Merge metadata files
    Audience
      Misskey admins
      Self-hosted servers
    Outputs
      Import-ready folder
      Structured metadata
      Deduplicated files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Gather tens of thousands of custom emoji from federated servers into a Misskey-importable folder in a single run.

VIBE 2

Merge and compare metadata files from previous runs to keep your emoji library updated over time.

VIBE 3

Respectfully collect shared emoji without overwhelming or spamming other servers in the network.

what's the stack?

Haskell

how it stacks up fr

eternal-flame-ad/fedi-emoji-toolpsibi/yesod-postgrestchayen/lambda-chat
Stars643
LanguageHaskellHaskellHaskell
Last pushed2024-09-282018-08-242018-03-18
MaintenanceStaleDormantDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a Haskell build environment and a Misskey server with a healthy federation count to get meaningful results.

No license information is provided in the repository, so usage rights are unclear.

in plain english

Fedi-Emoji-Tool helps people running their own Misskey community servers quickly build a big library of custom emoji. On platforms like Misskey and Mastodon, users love expressive custom emoji, but collecting thousands of them from across the network is tedious and can overwhelm other servers if done carelessly. This tool automates the process while being deliberately polite to the servers it contacts. The tool starts from a "home server" that already has connections to roughly a thousand or more other federated instances. It scans those connected servers to see what custom emoji are in use, records unique emoji in a structured file, and then downloads the ones that pass several community-respect filters. For instance, it won't grab emoji marked as licensed, sensitive, or local-only. It also skips emoji that appear on very few servers (by default, fewer than five), on the assumption that rare emoji are likely original artwork not meant to be shared widely. Downloads are throttled per instance, shuffled in order, and never duplicated, so no single server gets spammed. The final output is a folder structured for direct import back into Misskey. This is built for administrators of self-hosted Misskey instances who want to offer their users a rich emoji catalog without hand-curating it. Someone running a small personal server with a healthy federation count could use it to gather tens of thousands of emoji in a single pass. The author notes that on their own instance with 6,600 federations, the tool surfaced roughly 47,000 unique emoji under default filters. The project is written in Haskell and designed with memory constraints in mind, targeting under 8 GB of RAM for a full 47,000-emoji pack. Large-instance administrators may need to tune settings or contribute patches to avoid memory issues. The tool also includes helper commands to manage updates over time, such as merging or comparing metadata files from previous runs.

prompts (copy fr)

prompt 1
I run a self-hosted Misskey server with around 1,000 federated connections. Walk me through setting up and running fedi-emoji-tool to build a custom emoji library, including what filters it applies by default.
prompt 2
Help me configure fedi-emoji-tool so it stays under 8 GB of RAM while processing a large federation list of 6,000+ servers. What settings should I tune?
prompt 3
I have a metadata file from a previous fedi-emoji-tool run. Show me how to use the merge and compare helper commands to update my emoji collection with only new additions.
prompt 4
Explain how fedi-emoji-tool decides which emoji to skip, including the rules for licensed, sensitive, local-only, and rare emoji appearing on fewer than five servers.

Frequently asked questions

what is fedi-emoji-tool fr?

A tool for Misskey community server admins that automatically discovers and downloads custom emoji from connected federated servers, filtering out licensed or rare emoji, then packages everything for direct import back into Misskey.

What language is fedi-emoji-tool written in?

Mainly Haskell. The stack also includes Haskell.

Is fedi-emoji-tool actively maintained?

Stale — no commits in 1-2 years (last push 2024-09-28).

What license does fedi-emoji-tool use?

No license information is provided in the repository, so usage rights are unclear.

How hard is fedi-emoji-tool to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fedi-emoji-tool for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.