{"id":13657558,"url":"https://github.com/42wim/matterircd","last_synced_at":"2025-10-04T11:07:24.992Z","repository":{"id":39749333,"uuid":"45397023","full_name":"42wim/matterircd","owner":"42wim","description":"Connect to your mattermost or slack using your IRC-client of choice.","archived":false,"fork":false,"pushed_at":"2024-09-18T21:13:40.000Z","size":14304,"stargazers_count":297,"open_issues_count":27,"forks_count":60,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-05-22T21:09:59.042Z","etag":null,"topics":["irc","irc-server","ircd","mattermost","slack","tls-support"],"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/42wim.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":"2015-11-02T13:45:58.000Z","updated_at":"2025-04-24T11:31:32.000Z","dependencies_parsed_at":"2023-09-29T22:49:42.719Z","dependency_job_id":"2a4b8400-b62d-495e-9b21-84e90685097e","html_url":"https://github.com/42wim/matterircd","commit_stats":null,"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/42wim/matterircd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/42wim%2Fmatterircd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/42wim%2Fmatterircd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/42wim%2Fmatterircd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/42wim%2Fmatterircd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/42wim","download_url":"https://codeload.github.com/42wim/matterircd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/42wim%2Fmatterircd/sbom","scorecard":{"id":3981,"data":{"date":"2025-08-11","repo":{"name":"github.com/42wim/matterircd","commit":"ec4b62f3c941e62ce0d7a5fbd8503ed99154ba59"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Code-Review","score":2,"reason":"Found 6/30 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/development.yml:1","Warn: no topLevel permission defined: .github/workflows/docker.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/docker.yml:14"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Signed-Releases","score":8,"reason":"5 out of the last 5 releases have a total of 5 signed artifacts.","details":["Info: signed release artifact: checksums.txt.asc: https://github.com/42wim/matterircd/releases/tag/v0.28.0","Info: signed release artifact: checksums.txt.asc: https://github.com/42wim/matterircd/releases/tag/v0.27.1","Info: signed release artifact: checksums.txt.asc: https://github.com/42wim/matterircd/releases/tag/v0.27.0","Info: signed release artifact: checksums.txt.asc: https://github.com/42wim/matterircd/releases/tag/v0.26.1","Info: signed release artifact: checksums.txt.asc: https://github.com/42wim/matterircd/releases/tag/v0.26.0","Warn: release artifact v0.28.0 does not have provenance: https://api.github.com/repos/42wim/matterircd/releases/126497929","Warn: release artifact v0.27.1 does not have provenance: https://api.github.com/repos/42wim/matterircd/releases/115319727","Warn: release artifact v0.27.0 does not have provenance: https://api.github.com/repos/42wim/matterircd/releases/95252531","Warn: release artifact v0.26.1 does not have provenance: https://api.github.com/repos/42wim/matterircd/releases/82312882","Warn: release artifact v0.26.0 does not have provenance: https://api.github.com/repos/42wim/matterircd/releases/81698474"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:8: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/development.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/development.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/development.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docker.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/42wim/matterircd/docker.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating alpine:edge to alpine:edge@sha256:115729ec5cb049ba6359c3ab005ac742012d92bbaa5b8bc1a878f1e8f62c0cb8","Warn: goCommand not pinned by hash: vendor/github.com/json-iterator/go/build.sh:10","Warn: goCommand not pinned by hash: vendor/github.com/pelletier/go-toml/benchmark.sh:10","Info:   0 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   2 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 24 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"134 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-3wq5-3f56-v5xc","Warn: Project is vulnerable to: GHSA-63f2-6959-2pxj","Warn: Project is vulnerable to: GHSA-8jhh-3jf2-pfwr","Warn: Project is vulnerable to: GHSA-9hj7-v56g-rhf6","Warn: Project is vulnerable to: GHSA-7g2v-2frm-rg94","Warn: Project is vulnerable to: GHSA-455c-vqrf-mghr","Warn: Project is vulnerable to: GHSA-6xjj-v76v-fwpj","Warn: Project is vulnerable to: GHSA-9rww-66w7-7vjx","Warn: Project is vulnerable to: GHSA-g3v6-r8p9-wxg9","Warn: Project is vulnerable to: GHSA-p267-jjfq-pphf","Warn: Project is vulnerable to: GHSA-33r7-wjfc-7w98","Warn: Project is vulnerable to: GHSA-9hwp-cj7m-wjw4","Warn: Project is vulnerable to: GHSA-h69v-mvh9-hfrq","Warn: Project is vulnerable to: GHSA-h8wh-f7gw-fwpr","Warn: Project is vulnerable to: GHSA-rp65-jpc7-8h8p","Warn: Project is vulnerable to: GO-2024-2450 / GHSA-w88v-pjr8-cmv2","Warn: Project is vulnerable to: GHSA-r67m-mf7v-qp7j","Warn: Project is vulnerable to: GHSA-w496-f5qq-m58j","Warn: Project is vulnerable to: GHSA-xvq6-h898-wcj8","Warn: Project is vulnerable to: GHSA-3487-3j7c-7gwj","Warn: Project is vulnerable to: GHSA-4ghx-8jw8-p76q","Warn: Project is vulnerable to: GHSA-85jj-c9jr-9jhx","Warn: Project is vulnerable to: GHSA-c37r-v8jx-7cv2","Warn: Project is vulnerable to: GHSA-j4c3-3h73-74m9","Warn: Project is vulnerable to: GHSA-jcgv-3pfq-j4hr","Warn: Project is vulnerable to: GHSA-jj46-9cgh-qmfx","Warn: Project is vulnerable to: GHSA-jjr7-372r-cx7x","Warn: Project is vulnerable to: GHSA-p5pr-vm3j-jxxf","Warn: Project is vulnerable to: GHSA-63cv-4pc2-4fcf","Warn: Project is vulnerable to: GHSA-7664-hcp7-f497","Warn: Project is vulnerable to: GO-2024-3164","Warn: Project is vulnerable to: GO-2024-3232","Warn: Project is vulnerable to: GO-2024-3227","Warn: Project is vulnerable to: GO-2024-3233","Warn: Project is vulnerable to: GO-2024-3234","Warn: Project is vulnerable to: GO-2024-3235","Warn: Project is vulnerable to: GO-2025-3392","Warn: Project is vulnerable to: GO-2025-3393","Warn: Project is vulnerable to: GO-2025-3394","Warn: Project is vulnerable to: GO-2025-3407","Warn: Project is vulnerable to: GO-2025-3482","Warn: Project is vulnerable to: GO-2025-3377","Warn: Project is vulnerable to: GO-2025-3379","Warn: Project is vulnerable to: GO-2025-3380","Warn: Project is vulnerable to: GO-2025-3481","Warn: Project is vulnerable to: GO-2025-3480","Warn: Project is vulnerable to: GO-2025-3483","Warn: Project is vulnerable to: GO-2025-3611","Warn: Project is vulnerable to: GO-2025-3618","Warn: Project is vulnerable to: GO-2025-3619","Warn: Project is vulnerable to: GO-2025-3621","Warn: Project is vulnerable to: GO-2025-3622","Warn: Project is vulnerable to: GO-2025-3642","Warn: Project is vulnerable to: GO-2025-3643","Warn: Project is vulnerable to: GO-2025-3644","Warn: Project is vulnerable to: GO-2025-3556","Warn: Project is vulnerable to: GO-2025-3610","Warn: Project is vulnerable to: GO-2025-3609","Warn: Project is vulnerable to: GO-2025-3620","Warn: Project is vulnerable to: GO-2025-3623","Warn: Project is vulnerable to: GO-2025-3731","Warn: Project is vulnerable to: GO-2025-3691","Warn: Project is vulnerable to: GO-2025-3694","Warn: Project is vulnerable to: GO-2025-3724","Warn: Project is vulnerable to: GO-2025-3729","Warn: Project is vulnerable to: GO-2025-3730","Warn: Project is vulnerable to: GO-2025-3756","Warn: Project is vulnerable to: GO-2025-3728","Warn: Project is vulnerable to: GO-2025-3692","Warn: Project is vulnerable to: GO-2025-3693","Warn: Project is vulnerable to: GO-2025-3757","Warn: Project is vulnerable to: GO-2025-3796","Warn: Project is vulnerable to: GO-2025-3797","Warn: Project is vulnerable to: GO-2025-3769","Warn: Project is vulnerable to: GO-2025-3771","Warn: Project is vulnerable to: GO-2025-3772","Warn: Project is vulnerable to: GO-2025-3819","Warn: Project is vulnerable to: GO-2025-3820","Warn: Project is vulnerable to: GO-2025-3818","Warn: Project is vulnerable to: GO-2024-2448 / GHSA-q7rx-w656-fwmv","Warn: Project is vulnerable to: GO-2024-2541","Warn: Project is vulnerable to: GO-2024-2566","Warn: Project is vulnerable to: GO-2024-2589","Warn: Project is vulnerable to: GO-2024-2591","Warn: Project is vulnerable to: GO-2024-2592","Warn: Project is vulnerable to: GO-2024-2635","Warn: Project is vulnerable to: GO-2024-2588","Warn: Project is vulnerable to: GO-2024-2590","Warn: Project is vulnerable to: GO-2024-2593","Warn: Project is vulnerable to: GO-2024-2594","Warn: Project is vulnerable to: GO-2024-2595","Warn: Project is vulnerable to: GO-2024-2695","Warn: Project is vulnerable to: GO-2024-2696","Warn: Project is vulnerable to: GO-2024-2706","Warn: Project is vulnerable to: GO-2024-3020","Warn: Project is vulnerable to: GO-2024-3022","Warn: Project is vulnerable to: GO-2024-3023","Warn: Project is vulnerable to: GO-2024-3024","Warn: Project is vulnerable to: GO-2024-3025","Warn: Project is vulnerable to: GO-2024-3028","Warn: Project is vulnerable to: GO-2024-3030","Warn: Project is vulnerable to: GO-2024-3031","Warn: Project is vulnerable to: GO-2024-3032","Warn: Project is vulnerable to: GO-2024-3092","Warn: Project is vulnerable to: GO-2024-3089","Warn: Project is vulnerable to: GO-2024-3090","Warn: Project is vulnerable to: GO-2024-3091","Warn: Project is vulnerable to: GO-2024-3093","Warn: Project is vulnerable to: GO-2024-3094","Warn: Project is vulnerable to: GO-2024-3096","Warn: Project is vulnerable to: GO-2024-3097","Warn: Project is vulnerable to: GO-2025-3534","Warn: Project is vulnerable to: GO-2025-3555","Warn: Project is vulnerable to: GO-2025-3604","Warn: Project is vulnerable to: GO-2024-3337","Warn: Project is vulnerable to: GO-2024-3338","Warn: Project is vulnerable to: GO-2024-3340","Warn: Project is vulnerable to: GO-2025-3549","Warn: Project is vulnerable to: GO-2025-3550","Warn: Project is vulnerable to: GO-2025-3551","Warn: Project is vulnerable to: GO-2025-3552","Warn: Project is vulnerable to: GO-2024-2444","Warn: Project is vulnerable to: GO-2024-2446","Warn: Project is vulnerable to: GO-2024-2707","Warn: Project is vulnerable to: GO-2024-3334","Warn: Project is vulnerable to: GO-2023-2402 / GHSA-45x7-px36-x8w8","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2023-2102 / GHSA-4374-p667-p6c8","Warn: Project is vulnerable to: GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-14T13:09:22.914Z","repository_id":39749333,"created_at":"2025-08-14T13:09:22.914Z","updated_at":"2025-08-14T13:09:22.914Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278302555,"owners_count":25964523,"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-04T02:00:05.491Z","response_time":63,"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":["irc","irc-server","ircd","mattermost","slack","tls-support"],"created_at":"2024-08-02T05:00:45.088Z","updated_at":"2025-10-04T11:07:24.950Z","avatar_url":"https://github.com/42wim.png","language":"Go","readme":"# matterircd\n\u003c!-- TOC --\u003e\n\n- [matterircd](#matterircd)\n    - [Compatibility](#compatibility)\n    - [Features](#features)\n    - [Binaries](#binaries)\n    - [Building](#building)\n    - [Config file](#config-file)\n    - [Usage](#usage)\n        - [Mattermost user commands](#mattermost-user-commands)\n        - [Slack user commands](#slack-user-commands)\n        - [Mastodon user commands](#mastodon-user-commands)\n    - [Docker](#docker)\n    - [FreeBSD](#freebsd)\n    - [Support/questions](#supportquestions)\n    - [FAQ](#faq)\n        - [mattermost login with sso/gitlab](#mattermost-login-with-ssogitlab)\n        - [slack sso login / xoxc tokens](#slack-sso-login--xoxc-tokens)\n    - [Guides](#guides)\n    - [Related](#related)\n\n\u003c!-- /TOC --\u003e\n\n[![Join the IRC chat at https://web.libera.chat/gamja/?channels=#matterircd](https://img.shields.io/badge/IRC-matterircd-green.svg)](https://web.libera.chat/gamja/?channels=#matterircd)\n\nMinimal IRC server which integrates with [mattermost](https://www.mattermost.org) and [slack](https://www.slack.com)\nTested on FreeBSD / Linux / Windows\n\n## Compatibility\n\n- Matterircd works with slack, mastodon and mattermost 6.x, 7.x\n\nMaster branch of matterircd should always work against latest STABLE mattermost release.\n\n## Features\n\n- support direct messages / private channels / edited messages / deleted messages / reactions\n- auto-join/leave to same channels as on mattermost\n- reconnects with backoff on mattermost restarts\n- support multiple users\n- support channel/direct message backlog (messages when you're disconnected from IRC/mattermost)\n- search messages (/msg mattermost search query)\n- scrollback support (/msg mattermost scrollback #channel limit)\n- away support\n- restrict to specified mattermost instances\n- set default team/server\n- WHOIS, WHO, JOIN, LEAVE, NICK, LIST, ISON, PRIVMSG, MODE, TOPIC, LUSERS, AWAY, KICK, INVITE support\n- support TLS (ssl)\n- support unix sockets\n- support LDAP logins (mattermost enterprise) (use your ldap account/pass to login)\n- \u0026users channel that contains members of all teams (if mattermost is so configured) for easy messaging\n- support for including/excluding channels from showing up in irc\n- supports mattermost roles (shows admins with @ status for now)\n- gitlab auth hack by using mmtoken cookie (see \u003chttps://github.com/42wim/matterircd/issues/29\u003e)\n- mattermost personal token support\n- support multiline pasting\n- prefixcontext option for mattermost (see \u003chttps://github.com/42wim/matterircd/blob/master/prefixcontext.md\u003e)\n  - threading support\n  - reactions support\n- ....\n\n## Binaries\n\nYou can find the binaries [here](https://github.com/42wim/matterircd/releases/latest)\n\n## Building\n\nGo 1.17+ is required\n\n```bash\ngo install github.com/42wim/matterircd\n```\n\nYou should now have matterircd binary in the bin directory:\n\n```bash\n$ ls ~/go/bin/\nmatterircd\n```\n\n## Config file\n\nSee [matterircd.toml.example](https://github.com/42wim/matterircd/blob/master/matterircd.toml.example)  \nRun with `matterircd --conf matterircd.toml`\n\n## Usage\n\n```bash\nUsage of ./matterircd:\n      --bind string      interface:port to bind to, or a path to bind to a Unix socket. (default \"127.0.0.1:6667\")\n      --conf string      config file (default \"matterircd.toml\")\n      --debug            enable debug logging\n      --tlsbind string   interface:port to bind to. (e.g 127.0.0.1:6697)\n      --tlsdir string    directory to look for key.pem and cert.pem. (default \".\")\n      --version          show version\n```\n\nMatterircd will listen by default on localhost port 6667.\nConnect with your favorite irc-client to localhost:6667\n\nFor TLS support you'll need to generate certificates.  \nYou can use this program [generate_cert.go](https://golang.org/src/crypto/tls/generate_cert.go) to generate key.pem and cert.pem\n\n### Mattermost user commands\n\nLogin with user/pass\n\n```\n/msg mattermost login \u003cserver\u003e \u003cteam\u003e \u003cusername/email\u003e \u003cpassword\u003e\n```\n\nLogin with personal token\n\n```\n/msg mattermost login \u003cserver\u003e \u003cteam\u003e \u003cusername/email\u003e token=\u003cyourpersonaltoken\u003e\n```\n\nLogin with MFA token\n\n```\n/msg mattermost login \u003cserver\u003e \u003cteam\u003e \u003cusername/email\u003e \u003cpassword\u003e MFAToken=\u003cmfatoken\u003e\n```\n\nSearch\n```\n/msg mattermost search query\n```\n\nScrollback\n```\n/msg mattermost scrollback #\u003cchannel\u003e|\u003cuser\u003e|\u003cpost/thread ID\u003e \u003climit\u003e\n```\ne.g. `/msg mattermost scrollback #bugs 100` shows the last 100 messages of *#bugs*\ne.g. `/msg mattermost scrollback zdofdf1nctgsj87xgt6oco1a3w 0` shows all messages from the thread with root/parent *zdofdf1nctgsj87xgt6oco1a3w*\n\nMark messages in a channel/from a user as read (when DisableAutoView is set).\n```\n/msg mattermost updatelastviewed \u003cchannel\u003e\n/msg mattermost updatelastviewed \u003cusername\u003e\n```\n\nPart/leave\n```\n/msg mattermost part #mychannel\n```\n\n### Slack user commands\n\nGet a slack token on \u003chttps://api.slack.com/custom-integrations/legacy-tokens\u003e\n\nLogin\n\n```\n/msg slack login \u003ctoken\u003e\n```\n\nOr use team/login/pass to login\n```\n/msg slack login \u003cteam\u003e \u003clogin\u003e \u003cpassword\u003e\n```\nAfter login it'll show you a token you can use for the token login\n\n## Docker\n\nA docker image for easily setting up and running matterircd on a server is available at [docker hub](https://hub.docker.com/r/42wim/matterircd/).\n\nRun the irc server on port 6667. You'll need to specify -bind 0.0.0.0:6667 otherwise it only listens on 127.0.0.1 in the container.\n\n```\ndocker run -p 6667:6667 42wim/matterircd:latest --bind 0.0.0.0:6667\n```\n\nNow you can connect with your IRC client to port 6667 on your docker host.\n\n### Mastodon user commands\n\n(still WIP)\n\nConfigure your mastodon settings  \nSee the `[mastodon]` section in [matterircd.toml.example](https://github.com/42wim/matterircd/blob/master/matterircd.toml.example)\n\nLogin\n\n```\n/msg mastodon login\n```\n\nYou'll see your timeline in #mastodon (automatically joined to that channel)\n\n## FreeBSD\n\nInstall the port.\n```\n# pkg install matterircd\n```\nOr with a local ports tree.\n```\n$ cd /usr/ports/net-im/matterircd\n# make install clean\n```\n\nEnable the service.\n```\necho \"matterircd_enable=\"YES\" \u003e\u003e /etc/rc.conf\n```\nCopy the default configuration and modify to your needs.\n```\n# cp /usr/local/etc/matterircd/matterircd.toml.sample /usr/local/etc/matterircd/matterircd.toml\n```\nStart the service.\n```\n# service matterircd start\n```\n\n## Support/questions\n\nWe're also on the `#matterircd` channel on irc.libera.chat\n\n## FAQ\n\n### can I use matterircd for multiple mattermost or slack servers?\n\nYes, but not in the same connection (would cause problems with channel/user name conflicts).  \nmatterircd supports multiple users, so you can configure your IRC client to have multiple networks that all connect to the same matterircd server.\n\n### mattermost login with sso/gitlab\n\nYou'll need to get the `MMAUTHTOKEN` from your cookies, login via the browser first.  \nThen in chrome run F12 - application - Storage/cookies - select your mattermostdomain and fetch the `MMAUTHTOKEN`\n\nNow login with `/msg mattermost login \u003cusername\u003e MMAUTHTOKEN=\u003cmytoken\u003e`  \n(if this doesn't work, try `/msg mattermost login \u003cusername\u003e token=\u003cmytoken\u003e`)\n\nSee \u003chttps://github.com/42wim/matterircd/issues/29\u003e for more information\n\nAlso see [#98](https://github.com/42wim/matterircd/issues/98#issuecomment-307308876) for a script that fetches it for you.\n\n### slack sso login / xoxc tokens\n\nTaken from: \u003chttps://github.com/insomniacslk/irc-slack\u003e\n\nLog via browser on the Slack team, open the browser's network tab in the developer tools, and look for an XHR transaction. Then look for the token (it starts with xoxc-) in the request data the auth cookie, contained in the d key-value in the request cookies (it looks like d=XXXX;)\n\nThen concatenate the token and the auth cookie using a | character, like this:\n\n`xoxc-XXXX|d=XXXX;`\nand use the above as your token with slack login\n\n`/msg slack login xoxc-XXXX|d=XXXX;`\n\n## Guides\n\nHere are some external guides and documentation that might help you get up and\nrunning more quickly:\n\n- [Breaking out of the Slack walled garden](https://purpleidea.com/blog/2018/06/22/breaking-out-of-the-slack-walled-garden/)\n\n## Contributors\n\n[![Contributors](https://contrib.rocks/image?repo=42wim/matterircd)](https://github.com/42wim/matterircd/graphs/contributors)\n\n## Related\n\n- [matterircd-complete](https://github.com/hloeung/matterircd-complete) - better irssi/mattermost/matterircd integration\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F42wim%2Fmatterircd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F42wim%2Fmatterircd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F42wim%2Fmatterircd/lists"}