{"id":27012900,"url":"https://github.com/firstdarkdev/skinatar","last_synced_at":"2025-07-15T12:12:43.104Z","repository":{"id":285644632,"uuid":"958856052","full_name":"firstdarkdev/skinatar","owner":"firstdarkdev","description":"Experimental minecraft avatar service for Simple Discord Link, Simple RPC and other mods.","archived":false,"fork":false,"pushed_at":"2025-04-01T21:54:57.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T22:46:36.727Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firstdarkdev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-01T21:54:13.000Z","updated_at":"2025-04-01T21:54:36.000Z","dependencies_parsed_at":"2025-04-01T22:46:39.721Z","dependency_job_id":"157836ac-b4a1-40d1-821e-01d5f583e4f6","html_url":"https://github.com/firstdarkdev/skinatar","commit_stats":null,"previous_names":["firstdarkdev/skinatar"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstdarkdev%2Fskinatar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstdarkdev%2Fskinatar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstdarkdev%2Fskinatar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstdarkdev%2Fskinatar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firstdarkdev","download_url":"https://codeload.github.com/firstdarkdev/skinatar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247174458,"owners_count":20896078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-04T12:18:24.305Z","updated_at":"2025-04-04T12:18:24.817Z","avatar_url":"https://github.com/firstdarkdev.png","language":"Go","readme":"## Skinatar\n\nExperimental minecraft avatar service for Simple Discord Link, Simple RPC and other mods.\n\nAs of now, this system is in testing, and not quite recommended for public use yet.\n\nYou are however, free to self-host this, for your own use.\n\n### What is this?\n\nThis is a simple Minecraft avatar api, that allows you to retrieve Minecraft Avatars, Heads or Full Body renders with either a UUID, Username or Texture Hash. This service should support Geyser Bedrock Accounts, as well as mods like Fabric Tailor.\n\n### Caching\n\nThe server itself, makes use of Caching to prevent spamming Mojang servers. Additionally, our production instance also uses Cloudflare caching.\n\nSkins and Usernames are cached for 2 hours (both on the server, and via Cloudflare), before they are pulled again.\n\n### Ratelimits\n\nRequests are limited to 5 requests per second. This is just to prevent frequent calls for skins, when trying to bypass the cloudflare cache, which would put additional load on our servers.\n\n---\n\n### How do I host this?\n\nSimple. Make a copy of the `docker-compose.yml` file found in this repo. Then, just run `docker compose up -d`. \n\nYou will need to handle your own URL management for this, either via Cloudflare Tunnels, Apache, NGINX or Nginx Proxy Manager. By default, the server uses port 8080. Caching is also up to you to configure. If you need help with this, we might be able to assist you via our discord server.\n\nIn the future, we might allow public usage of our hosted instance, once it's proven battle ready\n\n### Endpoints\n\nThe server includes the following endpoints for skins:\n\n- Head -\u003e `SERVERURL/head/{UUID|USERNAME|TEXTUREHASH}` or `SERVERURL/isometric/{UUID|USERNAME|TEXTUREHASH}`\n- Full Body -\u003e `SERVERURL/body/{UUID|USERNAME|TEXTUREHASH}`\n- Avatar -\u003e `SERVERURL/avarar/{UUID|USERNAME|TEXTUREHASH}`\n\n---\n\n### License\n\nThis application and code is licensed under MIT.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstdarkdev%2Fskinatar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirstdarkdev%2Fskinatar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstdarkdev%2Fskinatar/lists"}