{"id":14008530,"url":"https://github.com/kiwiirc/kiwibnc","last_synced_at":"2026-01-31T18:20:32.803Z","repository":{"id":38019426,"uuid":"170034918","full_name":"kiwiirc/kiwibnc","owner":"kiwiirc","description":null,"archived":false,"fork":false,"pushed_at":"2024-01-29T21:29:38.000Z","size":929,"stargazers_count":45,"open_issues_count":54,"forks_count":15,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-07-24T05:54:31.996Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kiwiirc.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":"2019-02-10T22:31:29.000Z","updated_at":"2025-05-08T18:38:22.000Z","dependencies_parsed_at":"2024-05-01T23:54:42.257Z","dependency_job_id":"879a5a24-ec0f-45b3-80f7-12e1b651bcd0","html_url":"https://github.com/kiwiirc/kiwibnc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kiwiirc/kiwibnc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwiirc%2Fkiwibnc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwiirc%2Fkiwibnc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwiirc%2Fkiwibnc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwiirc%2Fkiwibnc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kiwiirc","download_url":"https://codeload.github.com/kiwiirc/kiwibnc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiwiirc%2Fkiwibnc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28949284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T14:26:55.697Z","status":"ssl_error","status_checked_at":"2026-01-31T14:26:52.545Z","response_time":128,"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":[],"created_at":"2024-08-10T11:01:47.002Z","updated_at":"2026-01-31T18:20:32.787Z","avatar_url":"https://github.com/kiwiirc.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# KiwiBNC - A modern IRC bouncer\n\n* Stay connected to IRC. For one person or 10,000 people\n* Zero downtime updates and restarts. Don't knock everyone offline because an update is available\n* Extensible via javascript plugins\n* Pick your own client. Older or modern IRCv3 clients\n* Websocket support for direct web clients\n* Built in web client\n* Web admin interface\n* Message storage via sqlite database or plain text files\n* RabbitMQ support for larger deployments\n\n## Status\nWhile KiwiBNC is already in use for single users and some networks it is currently in development and may break. If you require 100% uptime and rely on your BNC for your health, do not use it yet.\n\nFor general usage it is working and is currently being put to the test in live environments. However, as we learn more on how people use the project things may change at the moment.\n\n## Installation\n\n### Prerequisites\nMake sure to have installed on your system:\n* nodejs\n* npm\n\n### Download and install\n```shell\n$ git clone https://github.com/kiwiirc/kiwibnc.git\n$ cd kiwibnc\n$ npm install\n```\n\n## Usage\nRunning KiwiBNC for the first time will auto generate a config file in your home directory. You can also create your own using [this](https://github.com/kiwiirc/kiwibnc/blob/master/src/configProfileTemplate/config.ini) as a template and passing `--config=/path/to/config.ini` when running.\n\nYou may use environment vars by using the `$ENV_NAME` syntax - any instance of `$ENV_NAME` will be replaced by the `NAME` environment var. A `.env` file in the same directory as your config file will be loaded to provide extra environment vars at runtime.\n\n#### Add a user\n```shell\n$ node kiwibnc adduser\n01:09:17 [adduser] l_info Starting adduser\n01:09:17 [adduser] l_info Using config file /home/prawnsalad/.kiwibnc/config.ini\nUsername: someuser\nPassword: ****\nAdmin account? n\nAdded new user someuser\n```\n\n#### Starting the bouncer\n```shell\n$ node kiwibnc\n```\n\n#### Adding networks and controlling your bouncer\nConnect to your bouncer via your IRC client. Your password should be in the form of `username:password`. Once connected you will receive a private message from `*bnc` - this is your bouncer control buffer.\n\n```\n01:12 -!- Irssi: Starting query in localhost with *bnc\n01:12 \u003c*bnc\u003e Welcome to your BNC!\n01:12 \u003csomeuser\u003e addnetwork\n01:12 \u003c*bnc\u003e Usage: addnetwork name=example server=irc.example.net port=6697 tls=yes nick=mynick\n01:12 \u003c*bnc\u003e Available fields: name, server, port, tls, nick, username, realname, password\n01:12 \u003csomeuser\u003e addnetwork name=freenode server=irc.freenode.net port=6667 nick=somenick\n01:12 \u003c*bnc\u003e New network saved. You can now login using your_username/freenode:your_password\n```\n\nSend `help` to `*bnc` for all the commands you can send.\n\n\n## IRCv3 support\n\nIRCv3 capable IRC servers and clients are both supported. For a full capabilities list, see https://ircv3.net/software/clients#bouncers\n\n## License\n[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwiirc%2Fkiwibnc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiwiirc%2Fkiwibnc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwiirc%2Fkiwibnc/lists"}