{"id":14979764,"url":"https://github.com/evalle/bm-cat","last_synced_at":"2026-02-07T19:01:49.684Z","repository":{"id":76969340,"uuid":"154542099","full_name":"Evalle/bm-cat","owner":"Evalle","description":"Black Metal Cat Bot for Telegram","archived":false,"fork":false,"pushed_at":"2023-05-01T20:26:00.000Z","size":12038,"stargazers_count":7,"open_issues_count":6,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-07T05:43:23.572Z","etag":null,"topics":["blackmetal","bm-cat","bot","music","telegram","youtube","youtube-api","youtube-channel","youtube-player","youtube-playlist","youtube-search"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/Evalle.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-24T17:34:51.000Z","updated_at":"2024-05-19T12:26:22.000Z","dependencies_parsed_at":"2024-10-11T20:02:15.860Z","dependency_job_id":"e899f6ab-5779-410d-9be5-8b6987cb50db","html_url":"https://github.com/Evalle/bm-cat","commit_stats":{"total_commits":69,"total_committers":5,"mean_commits":13.8,"dds":0.5942028985507246,"last_synced_commit":"f3ab01eebc32d162e3805b73bd8904a97cc92ea3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Evalle/bm-cat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evalle%2Fbm-cat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evalle%2Fbm-cat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evalle%2Fbm-cat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evalle%2Fbm-cat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Evalle","download_url":"https://codeload.github.com/Evalle/bm-cat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evalle%2Fbm-cat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29204948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T17:44:10.191Z","status":"ssl_error","status_checked_at":"2026-02-07T17:44:07.936Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blackmetal","bm-cat","bot","music","telegram","youtube","youtube-api","youtube-channel","youtube-player","youtube-playlist","youtube-search"],"created_at":"2024-09-24T14:00:36.767Z","updated_at":"2026-02-07T19:01:49.668Z","avatar_url":"https://github.com/Evalle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Black Metal Cat Bot\n\nBlack Metal Cat Bot for Telegram\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2839811/47450333-4589fb80-d7c5-11e8-85e9-9d242fc01063.jpg\" alt=\"BM cat\" width=\"200\" height=\"200\"\u003e   \n\n## Build Status\n[![Build Status](https://travis-ci.com/Evalle/bm-cat.svg?branch=master)](https://travis-ci.com/Evalle/bm-cat)\n\n## Whoami\n\n- Telegram Bot\n- Written in Python 3\n- you can ask me for some new black metal album via \"BM!\" message\n- I will search the YouTube channels ([Black Metal Promotion](https://www.youtube.com/channel/UCzCWehBejA23yEz3zp7jlcg) and [Atmospheric Black Metal](https://www.youtube.com/channel/UCDLkzWN1rHY4eYkGnVruHVw))\n- ... and I will paste the link to the new black metal album into Telegram Channel\n- ... together with a funny random Black Metal quote, like *\"The problem with most Norwigian bands is that their singers sound like Popay\"* - **Cronos from Venom shared his thoughts in 1999**, see more [here](https://steemit.com/music/@worldofmusic/black-metal-most-creepy-quotes)\n\n## How Does it Work\n\n![GIF](howto.gif)\n\n## How to Use\n\nJust add BM-Cat bot into your chat and start a private conversation with him\nvia @.\n\n## Quickstart Guide\n\nIf you want to deploy your own Black Metal bot, use the instruction below.\n\n### Prerequisites\n\n- `python` version 3.7+\n- `pip3` version 18.1+\n- `docker` version 18.06.1-ce+\n\n### Environment Variables\n\nName                        | Description\n----------------------------|--------------------------------------------------------------------------------------\nBM_CAT_SSL_CERTIFICATE_PATH | The path to a SSL certificate inside of a container (for example: `/etc/ssl/certs/public.pem`)\nBM_CAT_PRIVATE_KEY_PATH     | The path to a private key (for example: `/etc/ssl/private/privkey.pem`)\nPORT                        | The port on which container should run (container port), (for example: `5000`)\nBM_CAT_HOST                 | The name of the host on which BM-cat bot is running (for example: `example.com`)\nBM_CAT_PORT                 | The host port (for example: `8443`)\nBM_CAT_API_KEY              | Telegram API KEY (see more [here](https://core.telegram.org/api/obtaining_api_id))\nBM_YOUTUBE_API_KEY          | YouTube API KEY (see more [here](https://developers.google.com/youtube/v3/getting-started))\n\n### Installation\n\n1. Clone this repository and change the current directory to `bm-cat`\n\n    ```bash\n    git clone https://github.com/Evalle/bm-cat.git\n    ```\n\n1. Install all python dependencies via:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n1. Generate self-signed certificate pair, (see more [here](https://core.telegram.org/bots/self-signed))\n\n    ```bash\n    openssl req -newkey rsa:2048 -sha256 -nodes -keyout private.key -x509 -days 365 \\\n                -out public.pem \\\n                -subj \"/C=US/ST=New York/L=Brooklyn/O=Example Brooklyn Company/CN=YOURDOMAIN.EXAMPLE\"\n    ```\n\n1. Build docker image\n\n    ```bash\n    docker build --build-arg BM_CAT_SSL_CERTIFICATE_PATH=/etc/ssl/certs/public.pem \\\n                 --build-arg BM_CAT_PRIVATE_KEY_PATH=/etc/ssl/private/privkey.pem \\\n                 --build-arg PORT=5000 --build-arg BM_CAT_HOST=example.com \\\n                 --build-arg BM_CAT_PORT=8443 \\\n                 --build-arg BM_CAT_API_KEY=\u003cyour_telegram_api_key\u003e \\\n                 --build-arg BM_YOUTUBE_API_KEY=\u003cyour_youtube_api_key\u003e \\\n                 -t bm-cat:0.0.1 .\n    ```\n\n1. Finally, run docker container\n\n    ```bash\n    docker run -d --restart=always --privileged -p 8443:5000/tcp bm-cat:0.0.1\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevalle%2Fbm-cat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevalle%2Fbm-cat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevalle%2Fbm-cat/lists"}