{"id":28150610,"url":"https://github.com/samtherapy/fediverse-imagebot","last_synced_at":"2025-10-08T00:52:15.165Z","repository":{"id":43207191,"uuid":"445197783","full_name":"SamTherapy/fediverse-imagebot","owner":"SamTherapy","description":"MIRROR - A bot that posts local images to a fediverse instance","archived":true,"fork":false,"pushed_at":"2023-05-27T09:01:24.000Z","size":185848,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-15T03:14:59.500Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://git.froth.zone/sam/fediverse-imagebot","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"0bsd","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamTherapy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-06T14:26:55.000Z","updated_at":"2023-05-27T11:45:02.000Z","dependencies_parsed_at":"2023-02-14T03:46:20.616Z","dependency_job_id":null,"html_url":"https://github.com/SamTherapy/fediverse-imagebot","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/SamTherapy/fediverse-imagebot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Ffediverse-imagebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Ffediverse-imagebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Ffediverse-imagebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Ffediverse-imagebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamTherapy","download_url":"https://codeload.github.com/SamTherapy/fediverse-imagebot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Ffediverse-imagebot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278872154,"owners_count":26060525,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-05-15T03:14:11.844Z","updated_at":"2025-10-08T00:52:15.160Z","avatar_url":"https://github.com/SamTherapy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fediverse-imagebot\n\n[![Build Status](https://ci.git.froth.zone/api/badges/sam/fediverse-imagebot/status.svg)](https://ci.git.froth.zone/sam/fediverse-imagebot)\n\nA bot that posts local and booru images to the Fediverse.\n\nCompatible with Mastodon, Misskey and Pleroma!\n\n## MIGRATING MAJOR VERSIONS\n\nSee [the wiki](https://git.froth.zone/sam/fediverse-imagebot/wiki/Migrating).\n\n## Boorus supported\n\nThe full list of boorus supported is found [here](https://github.com/AtoraSuunva/booru/blob/master/src/sites.json).\n\n## Downloading the bot\n\nThere are currently three ways to do this, a pre-built binary that bundles in node, from npm, or building from source. Both are listed below.\n\n### From NPM\n\n1. Set up using the [Gitea registry](https://git.froth.zone/sam/fediverse-imagebot/packages)\n\n   ```sh\n   npm config set @froth:registry https://git.froth.zone/api/packages/sam/npm/\n   ```\n\n2. After setting up the registry, either run it once\n\n   ```sh\n   npx --package=@froth/fediverse-imagebot fediverse-imagebot\n   ```\n\n   or install globally\n\n   ```sh\n   npm i -g @froth/fediverse-imagebot\n   ```\n\n### Downloading pre-built binaries\n\n#### NOTE: This is no longer supported since vercel/pkg is broken\n\nDownload prebuilt binaries from [here](https://git.froth.zone/sam/fediverse-imagebot/releases/latest). (currently supports x86_64 and arm64 on Linux\n[glibc or musl], macOS and Windows)\n\n1. Run the bot with the `-w` flag to have it generate a configuration file to the local directory.\n2. Edit it for your use case.\n   - If you want to generate a key you can use \u003chttps://git.froth.zone/sam/js-feditoken\u003e\n3. Run the bot by launching the executable!\n\n### Running from Source\n\n1. You need to have `npm` and `nodejs` installed.\n   - Node 16 or greater is required.\n2. Install `pnpm`: \\\n   `corepack enable` \\\n    Check \u003chttps://pnpm.io/installation\u003e for more information.\n3. Clone the repository: \\\n   `git clone https://git.froth.zone/sam/fediverse-imagebot.git`\n4. Install dependencies: \\\n   `pnpm i`\n5. Build: \\\n   `pnpm run build`\n6. Edit the config file: \\\n   `cp config.sample.jsonc config.jsonc`\n   - If you want to generate a key you can use https://git.froth.zone/sam/js-feditoken\n7. Run the bot: \\\n   `pnpm bot`\n\nYou're done! The bot should post a local image to the fediverse instance of your choosing!\n\n## Automating the bot\n\n_TODO: Elaborate more_\n\nThe bot can be automated to post images at set times using a cronjob. \\\nExample cron configuration:\n\n```\n0 * * * * cd /path/to/fediverse-imagebot \u0026\u0026 pnpm bot -c ./config.sample.jsonc\n```\n\nThis example will run the bot every hour on the hour with no message using images from the default `images` directory.\n\nAn example of this pleroma configuration can be found at https://froth.zone/rinbot.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamtherapy%2Ffediverse-imagebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamtherapy%2Ffediverse-imagebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamtherapy%2Ffediverse-imagebot/lists"}