{"id":16621770,"url":"https://github.com/ravener/img-api","last_synced_at":"2025-09-01T20:44:39.440Z","repository":{"id":52356300,"uuid":"265216699","full_name":"ravener/img-api","owner":"ravener","description":"Image Manipulation API server written in GoLang primarily for Discord Bots","archived":false,"fork":false,"pushed_at":"2023-02-11T04:28:43.000Z","size":11080,"stargazers_count":21,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-02T05:04:16.598Z","etag":null,"topics":["api","discord","discord-bot","go","golang","image-manipulation","meme-generator","memes","self-hosted"],"latest_commit_sha":null,"homepage":"","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/ravener.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2020-05-19T10:29:03.000Z","updated_at":"2024-10-17T18:37:53.000Z","dependencies_parsed_at":"2024-06-19T00:27:12.543Z","dependency_job_id":"9f6ea0bf-1d65-4883-ae52-089eec78d6f4","html_url":"https://github.com/ravener/img-api","commit_stats":{"total_commits":37,"total_committers":4,"mean_commits":9.25,"dds":"0.29729729729729726","last_synced_commit":"762cb963bcc00aa3e9259d6a997363a6c332936d"},"previous_names":["pollen5/img-api"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravener%2Fimg-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravener%2Fimg-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravener%2Fimg-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ravener%2Fimg-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ravener","download_url":"https://codeload.github.com/ravener/img-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238900128,"owners_count":19549457,"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":["api","discord","discord-bot","go","golang","image-manipulation","meme-generator","memes","self-hosted"],"created_at":"2024-10-12T02:48:24.127Z","updated_at":"2025-02-14T19:33:41.855Z","avatar_url":"https://github.com/ravener.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Image API\n\nThis is an API written in Golang for image manipulation commands, primarily targets usage from [Discord](https://discord.com) Bots.\n\nIt is used in my bot [Miyako](https://github.com/ravener/miyako) and anyone is free to use this.\n\nThere used to be an API with the name \"Idiotic API\" by York. It was great while it lasted but it died now I tried to reinvent some of the endpoints that API had, this time it's open source and self-hosted so it will always be available to you.\n\n## Install\nPre-built binaries are available for Windows, macOS and Linux in [GitHub Releases](https://github.com/ravener/img-api/releases), the easiest way to get started is to just download a release which includes everything needed to get started in your machine without installing anything else.\n\nSimply extract the archive and run the `img-api` binary (`img-api.exe` on Windows)\n\nOn Linux/macOS you can type `./img-api` to run it, on Windows you may just double click the exe or type `img-api` in cmd. (Make sure you are in the correct directory)\n\nIf you are on Linux/macOS you may also install via [Homebrew](https://brew.sh) just run: `brew install ravener/tap/img-api`\n\nThe API will start in `http://localhost:3030` but the port can be changed via `-p`\n\nIf the prebuilt binaries doesn't suit you or you'd like to edit the code then continue for instructions on building, this will require [Golang 1.13+](https://golang.org) installed.\n\n## Setup (No Docker)\nInstall Golang 1.13+ (`git` must also be installed) then clone this repository.\n```sh\n$ git clone https://github.com/ravener/img-api\n$ cd img-api\n# Build the binary\n$ go build\n# start the server\n$ ./img-api\n```\n\n# Setup (Docker)\nTo run with docker you can use\n```sh\n# Replace target port with the one you want to use on your host (this only exposes it locally)\ndocker run -d -p \u003ctarget\u003e:3030 iceemc/img-api:latest\n# To expose the server on all interfaces\ndocker run -d -p 0.0.0.0:\u003ctarget\u003e:3030 iceemc/img-api:latest\n```\n\n# Setup (Pterodactyl)\nJust follow the below instructions in order, indicated by the **big numbers**\n![image](https://user-images.githubusercontent.com/30955604/116635544-0fe1a280-a92d-11eb-9837-8b03f1dd333f.png)\n\n\nAll API endpoints are listed in [Endpoints.md](Endpoints.md)\n\n## Local Usage or Shared?\nThere are 2 ways to use this. The first one is the recommended and easiest way: locally.\n\nThe server can be accessed only via the same host, only for your bot. This is the default behaviour.\n\nIf you want to expose the server to the internet (e.g to share it with a friend.) then you have to run it with `-h 0.0.0.0` but anyone who knows your server IP and port will be able to use the API so you might consider adding some sort of authorization. Run it with `-s password` where password is a secret authorization that you will only share with users you trust and they will have to add an `Authorization` header with it. Requests from localhost won't be required to authenticate and will work as normal.\n\n## Wrappers\nI wrote some API wrappers in multiple languages to help users get started quickly.\n\n- [JavaScript](https://github.com/ravener/img-api.js)\n- [Python](https://github.com/ravener/img-api.py)\n- [Golang](https://github.com/ravener/img-api-go)\n\n**Unofficial Wrappers:**\n- If you made any new wrappers then feel free to add it to this list.\n\nOfficial wrappers are promised to stay updated with all changes where as unofficial ones depends on the person who made them.\n\n## Contributing\nContributions are welcome, whether it is new image template ideas or code contributions. Feel free to open any issues when in doubt.\n\nAlso join [`#img-api` in my Discord Server](https://discord.gg/wpE3Nfp) for contacting me and getting updates.\n\nTip: If you use a web-browser to test the images output in development, pass the `-d` flag to disable browser cache to make testing easier.\n\n## License\nReleased under the [MIT License](LICENSE)\n\nI do not own the assets provided.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravener%2Fimg-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fravener%2Fimg-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravener%2Fimg-api/lists"}