···11+# SPDX-License-Identifier: AGPL-3.0-only
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33+cask "lovr-playspace" do
44+ version "0.2.1"
55+ sha256 "996e863b6d4d725d3d18fd3a27b5ea503d55d281c2f15332c2556a1484f503fa"
66+77+ url "https://github.com/SpookySkeletons/lovr-playspace/releases/download/#{version}/LOVR_Playspace-x86_64.AppImage"
88+ name "LÖVR Playspace"
99+ desc "Room boundary overlay for OpenXR"
1010+ homepage "https://github.com/SpookySkeletons/lovr-playspace"
1111+1212+ livecheck do
1313+ url #{homepage}
1414+ strategy :git
1515+ end
1616+1717+ depends_on arch: :x86_64
1818+1919+ # TODO: Switch to appimage when https://github.com/Homebrew/brew/pull/20334 is merged?
2020+ binary "LOVR_Playspace-x86_64.AppImage", target: "lovr-playspace"
2121+2222+ # TODO: Look for files that should go here
2323+ zap trash: ""
2424+end
+28
Casks/wayvr-dashboard.rb
···11+# SPDX-License-Identifier: AGPL-3.0-only
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33+cask "wayvr-dashboard" do
44+ version "0.3.8"
55+ sha256 "513484de85bba6ab575329d42259bd782c0a5c7a9aa925090d3a25f05c2936ed"
66+77+ url "https://github.com/olekolek1000/wayvr-dashboard/releases/download/#{version}/wayvr-dashboard.x86_64"
88+ name "WayVR Dashboard"
99+ desc "Launch desktop applications and games within VR (wlx-overlay-s addon)"
1010+ homepage "https://oo8.dev/wayvr_dashboard"
1111+1212+ livecheck do
1313+ url "https://github.com/olekolek1000/wayvr-dashboard"
1414+ strategy :git
1515+ end
1616+1717+ depends_on arch: :x86_64
1818+ depends_on formula: "wlx-overlay-s"
1919+2020+ binary "wayvr-dashboard.x86_64", target: "wayvr-dashboard"
2121+2222+ zap trash: [
2323+ "~/.local/share/dev.oo8.wayvr-dashboard",
2424+ "~/.local/share/wayvr-dashboard",
2525+ "~/.cache/dev.oo8.wayvr-dashboard",
2626+ "~/.cache/wayvr-dashboard"
2727+ ]
2828+end
+9-6
Formula/atomicxr-cli.rb
···11# SPDX-License-Identifier: AGPL-3.0-only
22-# Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com>
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33class AtomicxrCli < Formula
44 desc "Utilities for XR on Fedora Atomic Desktops and Universal Blue"
55- homepage "https://tangled.sh/@matrixfurry.com/homebrew-atomicxr"
66- url "https://knot1.tangled.sh/did:plc:zmjoeu3stwcn44647rhxa44o/atomic-xr/archive/v1.2.0.tar.gz"
77- sha256 "0339abba3a60ffe0dec938d212b1abee9eaefabc068ce6df4ee1038036e1db7d"
55+ homepage "https://tangled.org/matrixfurry.com/atomic-xr"
66+ version "2.6.0"
77+ url "https://tangled.org/matrixfurry.com/atomic-xr/archive/refs%2Ftags%2Fv#{version}"
88+ sha256 "03d382a66b67baeaeeedad0fee9b344b18921fdae1838aa55f3d2e5129353e61"
89 license "AGPL-3.0-only"
9101010- # livecheck will be implemented after this pr is merged: https://tangled.sh/@tangled.sh/core/pulls/442
1111- # alternatively, we could use the git strategy, but that's not ideal iirc
1111+ bottle do
1212+ root_url "https://gitlab.com/api/v4/projects/75293878/packages/generic/atomicxr-cli/2.6.0"
1313+ sha256 cellar: :any_skip_relocation, x86_64_linux: "c3dc78fe3e06a11abc8ec1f415153b9c156da7bcac65bdd2f357f3fa7f825905"
1414+ end
12151316 depends_on "nushell"
1417
+27
Formula/disabled/wayvr-dashboard.rb
···11+# SPDX-License-Identifier: AGPL-3.0-only
22+# Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com>
33+class WayvrDashboard < Formula
44+ desc "Launch desktop applications and games within VR (wlx-overlay-s addon)"
55+ homepage "https://oo8.dev/wayvr_dashboard"
66+ url "https://github.com/olekolek1000/wayvr-dashboard/releases/download/0.3.7/wayvr-dashboard"
77+ sha256 "3e5227f95497037c9ecdc03320fb943f2db0ad492e75d7702de6301a7baf0286"
88+ license "MIT"
99+ revision 1
1010+1111+ disable! date: "2025-09-06", because: "has been replaced by a cask", replacement_cask: "wayvr-dashboard"
1212+1313+ # HACK: There are major issues when attempting to run GTK applications built with Homebrew on
1414+ # HACK: ...atomic distros at the moment. For now, we're just installing the prebuilt binary.
1515+1616+ def install
1717+ bin.install "wayvr-dashboard"
1818+ end
1919+2020+ def caveats
2121+ "WayVR Dashboard has been installed from a prebuilt binary"
2222+ end
2323+2424+ test do
2525+ # TODO: add tests
2626+ end
2727+end
+32
Formula/index-camera-passthrough.rb
···11+# SPDX-License-Identifier: AGPL-3.0-only
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33+class IndexCameraPassthrough < Formula
44+ desc "Experimental Valve Index camera passthrough for Linux"
55+ homepage "https://github.com/yshui/index_camera_passthrough"
66+ url "https://github.com/yshui/index_camera_passthrough/archive/0d3ec30c5cd74e4a3df93d704ecf4a25136afd73.zip"
77+ version "2024.07.25"
88+ sha256 "967d967b08299727810d623cdc50260767c7fe715ed97e932281ae029a971728"
99+ license "MIT"
1010+1111+ bottle do
1212+ root_url "https://gitlab.com/api/v4/projects/75293878/packages/generic/index-camera-passthrough/2024.07.25"
1313+ sha256 cellar: :any_skip_relocation, x86_64_linux: "f48692400b509fb0ec25e9b4351f8a7a4dd9b15a12f889a0674386c539684d17"
1414+ end
1515+1616+ depends_on "rust" => :build
1717+ depends_on "shaderc" => :build
1818+ depends_on "llvm" => :build
1919+ depends_on "systemd"
2020+ depends_on :linux
2121+2222+ def install
2323+ ENV["SHADERC_LIB_DIR"] = Formula["shaderc"].opt_lib.to_s
2424+2525+ system "cargo", "install", *std_cargo_args
2626+ end
2727+2828+ test do
2929+ # TODO: write tests
3030+ system "false"
3131+ end
3232+end
+10-24
Formula/libpipewire.rb
···11# SPDX-License-Identifier: AGPL-3.0-only
22-# Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com>
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33class Libpipewire < Formula
44 desc "User space API to deal with multimedia pipelines (libraries only)"
55 homepage "https://pipewire.org/"
66- url "https://gitlab.freedesktop.org/pipewire/pipewire/-/archive/1.4.7/pipewire-1.4.7.tar.gz"
77- sha256 "9d54f025e1e7ae73b980a6c8be2e8e6387e24d554d58478d6495734ce1ee5a93"
66+ version "1.5.83"
77+ url "https://gitlab.freedesktop.org/pipewire/pipewire/-/archive/#{version}/pipewire-#{version}.tar.gz"
88+ sha256 "f9db39d52155481c2c40e8216901ef24cdc2235725afa6cd3a79461965ffc4ac"
89 license "MIT"
9101111+ bottle do
1212+ root_url "https://gitlab.com/api/v4/projects/75293878/packages/generic/libpipewire/1.5.83"
1313+ sha256 x86_64_linux: "92742f8ed60008a75ccf599596bd4de65aa10baf6d8e162a93d5400abf05f993"
1414+ end
1515+1016 keg_only "pipewire should be installed from your Linux distro's package manager, this formula is for builds only"
11171218 depends_on "dbus" => :build
1313- depends_on "gcc" => :build
1419 depends_on "glib" => :build
1520 depends_on "libffi" => :build
1621 depends_on "meson" => :build
···2631 # NOTE: Does disabling gsettings cause any issues?
2732 args = %w[
2833 -Dexamples=disabled
2929- -Dsystemd=disabled
3434+ -Dlibsystemd=disabled
3035 -Dlogind=disabled
3136 -Dpipewire-alsa=disabled
3237 -Dpipewire-jack=disabled
···4045 -Dsession-managers=[]
4146 ]
42474343- # HACK: temporarily disable fixincludes for pthread.h, see https://github.com/orgs/Homebrew/discussions/6193
4444- # Maybe building with LLVM clang would be a better idea?
4545- system "nu", "-c", "try {
4646- ls /home/linuxbrew/.linuxbrew/Cellar/gcc/*/lib/gcc/current/gcc/x86_64-pc-linux-gnu/*/include-fixed/pthread.h
4747- | each {|file| mv $file.name $'($file.name).bak'};
4848- print 'GCC Fixincludes disabled for `pthread.h`'
4949- } catch {
5050- print 'WARNING: Failed to disable pthread.h fixincludes from GCC.'
5151- }"
5252-5348 system "meson", "setup", "build", *args, *std_meson_args
5449 system "meson", "compile", "-C", "build"
5550 system "meson", "install", "-C", "build"
5656-5757- # HACK: re-enable pthread.h fixincludes
5858- system "nu", "-c", "try {
5959- ls /home/linuxbrew/.linuxbrew/Cellar/gcc/*/lib/gcc/current/gcc/x86_64-pc-linux-gnu/*/include-fixed/pthread.h.bak
6060- | each {|file| mv $file.name ($file.name | str substring 0..-5)};
6161- print 'GCC Fixincludes re-enabled for `pthread.h`'
6262- } catch {
6363- print 'WARNING: Failed to re-enable pthread.h fixincludes from GCC.'
6464- }"
6551 end
66526753 test do
···11-# SPDX-License-Identifier: AGPL-3.0-only
22-# Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com>
33-class WayvrDashboard < Formula
44- desc "Launch desktop applications and games within VR (wlx-overlay-s addon)"
55- homepage "https://oo8.dev/wayvr_dashboard"
66- url "https://github.com/olekolek1000/wayvr-dashboard/releases/download/0.3.6/wayvr-dashboard"
77- sha256 "33294727f2cea0a7db0fb1fb4ce3ea5fb34806d83baef4f229137c8d330dacda"
88- license "MIT"
99- revision 1
1010-1111- # HACK: There are major issues when attempting to run GTK applications built with Homebrew on
1212- # HACK: ...atomic distros at the moment. For now, we're just installing the prebuilt binary.
1313-1414- def install
1515- bin.install "wayvr-dashboard"
1616- end
1717-1818- def caveats
1919- "WayVR Dashboard has been installed from a prebuilt binary"
2020- end
2121-2222- test do
2323- # TODO: add tests
2424- end
2525-end
-50
Formula/wivrn-server.rb
···11-# Documentation: https://docs.brew.sh/Formula-Cookbook
22-# https://rubydoc.brew.sh/Formula
33-# PLEASE REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST!
44-class WivrnServer < Formula
55- desc "The Linux OpenXR streaming application to standalone headsets"
66- homepage "https://github.com/WiVRn/WiVRn"
77- url "https://github.com/WiVRn/WiVRn/archive/refs/tags/v25.8.tar.gz"
88- sha256 "7bfb0c270cab8bb95a1cab1402f8bc320398e7fcfd2be70ef1a5d4f4a9451a71"
99- license "GPL-3.0"
1010-1111- depends_on "cmake" => :build
1212- depends_on "eigen" => :build
1313- depends_on "avahi" => :build
1414- depends_on "gettext" => :build
1515- depends_on "pulseaudio" => :build
1616- depends_on "cli11" => :build
1717- depends_on "librsvg" => :build
1818- depends_on "libnotify" => :build
1919- depends_on "nlohmann-json" => :build
2020- depends_on "ffmpeg" => :build
2121- depends_on "x264" => :build
2222- depends_on "x265" => :build
2323-2424- def install
2525- args = %w[
2626- -GNinja
2727- -DWIVRN_BUILD_CLIENT=OFF
2828- -DCMAKE_BUILD_TYPE=RelWithDebInfo
2929- ]
3030-3131- system "cmake", "-B", "build-server", ".", *args, *std_cmake_args
3232- end
3333-3434- def caveats
3535- "AtomicXR's wivrn-server formula is in development. Report issues at: https://tangled.sh/@matrixfurry.com/homebrew-atomicxr/issues"
3636- end
3737-3838- test do
3939- # `test do` will create, run in and delete a temporary directory.
4040- #
4141- # This test will fail and we won't accept that! For Homebrew/homebrew-core
4242- # this will need to be a test that verifies the functionality of the
4343- # software. Run the test with `brew test wivrn-server`. Options passed
4444- # to `brew install` such as `--HEAD` also need to be provided to `brew test`.
4545- #
4646- # The installed folder is not in the path, so use the entire path to any
4747- # executables being tested: `system bin/"program", "do", "something"`.
4848- system "false"
4949- end
5050-end
+8-26
Formula/wlx-overlay-s.rb
···11# SPDX-License-Identifier: AGPL-3.0-only
22-# Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com>
22+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
33class WlxOverlayS < Formula
44 desc "Access your Wayland desktop from Monado/WiVRn"
55 homepage "https://github.com/galister/wlx-overlay-s"
66- url "https://github.com/galister/wlx-overlay-s/archive/refs/tags/v25.4.2.tar.gz"
66+ version "25.4.2"
77+ url "https://github.com/galister/wlx-overlay-s/archive/refs/tags/v#{version}.tar.gz"
78 sha256 "c2be093a815fa69fee65235bad573be8c1ac7959b5bad197f9e4201cc15da5ba"
89 license "GPL-3.0-only"
9101111+ bottle do
1212+ root_url "https://gitlab.com/api/v4/projects/75293878/packages/generic/wlx-overlay-s/25.4.2"
1313+ sha256 x86_64_linux: "a18928b0cc02ba40184735a3ac599c29405f38600ba48d8676611a6e956bd308"
1414+ end
1515+1016 depends_on "alsa-lib" => :build
1117 depends_on "dbus" => :build
1212- depends_on "gcc" => :build
1318 depends_on "libpipewire" => :build
1419 depends_on "libxkbcommon" => :build
1520 depends_on "nushell" => :build
···2429 def install
2530 ENV["SHADERC_LIB_DIR"] = Formula["shaderc"].opt_lib.to_s
26312727- # HACK: temporarily disable fixincludes for pthread.h, see https://github.com/orgs/Homebrew/discussions/6193
2828- # Maybe building with LLVM clang would be a better idea?
2929- system "nu", "-c", <<~EOF
3030- try {
3131- ls /home/linuxbrew/.linuxbrew/Cellar/gcc/*/lib/gcc/current/gcc/x86_64-pc-linux-gnu/*/include-fixed/pthread.h
3232- | each {|file| mv $file.name $'($file.name).bak'};
3333- print 'GCC Fixincludes disabled for `pthread.h`'
3434- } catch {
3535- print 'WARNING: Failed to disable pthread.h fixincludes from GCC.'
3636- }
3737- EOF
3838-3932 system "cargo", "install",
4033 "--no-default-features",
4134 "--features", "openxr,wayland,pipewire,osc,wayvr",
4235 *std_cargo_args
4343-4444- # HACK: re-enable pthread.h fixincludes
4545- system "nu", "-c", <<~EOF
4646- try {
4747- ls /home/linuxbrew/.linuxbrew/Cellar/gcc/*/lib/gcc/current/gcc/x86_64-pc-linux-gnu/*/include-fixed/pthread.h.bak
4848- | each {|file| mv $file.name ($file.name | str substring 0..-5)};
4949- print 'GCC Fixincludes re-enabled for `pthread.h`'
5050- } catch {
5151- print 'WARNING: Failed to re-enable pthread.h fixincludes from GCC.'
5252- }
5353- EOF
5436 end
55375638 def caveats
+24-6
README.md
···2233Homebrew tap for XR applications on Fedora Atomic
4455+> [!IMPORTANT]
66+> AtomicXR is looking for a new maintainer. This tap should still be updated weekly.
77+> If you notice any problems, please [open an issue](https://tangled.org/@matrixfurry.com/homebrew-atomicxr/issues/new)!
88+>
99+> See [this blog post](https://blog.matrixfurry.com/3m3q3ok4nus2o) for more information.
1010+511## Install ##
612713Tap:
814```sh
99-brew tap matrixfurry.com/atomicxr https://tangled.sh/@matrixfurry.com/homebrew-atomicxr
1515+brew tap matrixfurry.com/atomicxr https://tangled.org/@matrixfurry.com/homebrew-atomicxr
1016```
11171212-Applications (`brew install <application>`):
1818+Formulae (`brew install <application>`):
1319- [AtomicXR CLI (`axr`)](https://tangled.sh/@matrixfurry.com/atomic-xr): `atomicxr-cli`
1420- [WlxOverlay-S](https://github.com/galister/wlx-overlay-s): `wlx-overlay-s`
1515-- [WayVR Dashboard](https://github.com/olekolek1000/wayvr-dashboard): `wayvr-dashboard`
1621- [Monado Tracking Origin Calibrator](https://github.com/galister/motoc): `motoc`
1722- [OSC Avatar Manager](https://github.com/galister/oscavmgr): `oscavmgr`
1823- [VrcAdvert](https://github.com/galister/VrcAdvert): `vrc-advert`
2424+- [Index Camera Passthrough](https://github.com/yshui/index_camera_passthrough): `index-camera-passthrough`
19252020-## Common Issues ##
2626+Casks (`brew install --cask <application>`):
2727+- [WayVR Dashboard](https://github.com/olekolek1000/wayvr-dashboard): `wayvr-dashboard`
2828+- [LÖVR Playspace](https://github.com/SpookySkeletons/lovr-playspace): `lovr-playspace`
2929+3030+## Performance ##
3131+If you want slightly better runtime CPU performance, you can build from source using `brew install --build-from-source <application>`
3232+3333+All Bottles are built for `x86_64-v3`, which should be a good balance between performance and compatibility.
3434+3535+## Troubleshooting ##
21362237### Formulae found in multiple taps
2338If you had this tap or AtomicXR installed before Aug 10, 2025, you might see an error message like:
···35503651To fix this, run `brew unlink xkeyboard-config; brew link xkeyboard-config --overwrite`
37523838-## License ##
5353+### Issues with `pthread.h` or other fixincludes while building formulae
5454+This is caused by using Homebrew's GCC instead of Fedora's. Make sure Homebrew GCC is uninstalled and not a dependency.
5555+5656+## Security ##
39574040-The Formulae and scripts in this repo are licensed under the AGPL 3.0 (no later version) unless otherwise specified.
5858+Please see the [Security Policy](./docs/security.md)
+90
docs/code_of_conduct.md
···11+# Contributor Covenant 3.0 Code of Conduct
22+33+## Our Pledge
44+55+We pledge to make our community welcoming, safe, and equitable for all.
66+77+We are committed to fostering an environment that respects and promotes the dignity, rights, and contributions of all individuals, regardless of characteristics including race, ethnicity, caste, color, age, physical characteristics, neurodiversity, disability, sex or gender, gender identity or expression, sexual orientation, language, philosophy or religion, national or social origin, socio-economic position, level of education, or other status. The same privileges of participation are extended to everyone who participates in good faith and in accordance with this Covenant.
88+99+## Encouraged Behaviors
1010+1111+While acknowledging differences in social norms, we all strive to meet our community's expectations for positive behavior. We also understand that our words and actions may be interpreted differently than we intend based on culture, background, or native language.
1212+1313+With these considerations in mind, we agree to behave mindfully toward each other and act in ways that center our shared values, including:
1414+1515+1. Respecting the **purpose of our community**, our activities, and our ways of gathering.
1616+2. Engaging **kindly and honestly** with others.
1717+3. Respecting **different viewpoints** and experiences.
1818+4. **Taking responsibility** for our actions and contributions.
1919+5. Gracefully giving and accepting **constructive feedback**.
2020+6. Committing to **repairing harm** when it occurs.
2121+7. Behaving in other ways that promote and sustain the **well-being of our community**.
2222+2323+2424+## Restricted Behaviors
2525+2626+We agree to restrict the following behaviors in our community. Instances, threats, and promotion of these behaviors are violations of this Code of Conduct.
2727+2828+1. **Harassment.** Violating explicitly expressed boundaries or engaging in unnecessary personal attention after any clear request to stop.
2929+2. **Character attacks.** Making insulting, demeaning, or pejorative comments directed at a community member or group of people.
3030+3. **Stereotyping or discrimination.** Characterizing anyone’s personality or behavior on the basis of immutable identities or traits.
3131+4. **Sexualization.** Behaving in a way that would generally be considered inappropriately intimate in the context or purpose of the community.
3232+5. **Violating confidentiality**. Sharing or acting on someone's personal or private information without their permission.
3333+6. **Endangerment.** Causing, encouraging, or threatening violence or other harm toward any person or group.
3434+7. Behaving in other ways that **threaten the well-being** of our community.
3535+3636+### Other Restrictions
3737+3838+1. **Misleading identity.** Impersonating someone else for any reason, or pretending to be someone else to evade enforcement actions.
3939+2. **Failing to credit sources.** Not properly crediting the sources of content you contribute.
4040+3. **Promotional materials**. Sharing marketing or other commercial content in a way that is outside the norms of the community.
4141+4. **Irresponsible communication.** Failing to responsibly present content which includes, links or describes any other restricted behaviors.
4242+4343+4444+## Reporting an Issue
4545+4646+Tensions can occur between community members even when they are trying their best to collaborate. Not every conflict represents a code of conduct violation, and this Code of Conduct reinforces encouraged behaviors and norms that can help avoid conflicts and minimize harm.
4747+4848+When an incident does occur, it is important to report it promptly. To report a possible violation, **Please send a message via [SimpleX](https://smp18.simplex.im/a#Wc2x2IBqqwzgmeGkN0XtKrGMLBxFuxmoYgkTGgGgR0M), [Email](mailto:matrix@matrixfurry.com), or any of the contact methods listed [here](https://woosh.link/matrixfurry.com).**
4949+5050+Community Moderators take reports of violations seriously and will make every effort to respond in a timely manner. They will investigate all reports of code of conduct violations, reviewing messages, logs, and recordings, or interviewing witnesses and other participants. Community Moderators will keep investigation and enforcement actions as transparent as possible while prioritizing safety and confidentiality. In order to honor these values, enforcement actions are carried out in private with the involved parties, but communicating to the whole community may be part of a mutually agreed upon resolution.
5151+5252+5353+## Addressing and Repairing Harm
5454+5555+****
5656+5757+If an investigation by the Community Moderators finds that this Code of Conduct has been violated, the following enforcement ladder may be used to determine how best to repair harm, based on the incident's impact on the individuals involved and the community as a whole. Depending on the severity of a violation, lower rungs on the ladder may be skipped.
5858+5959+1) Warning
6060+ 1) Event: A violation involving a single incident or series of incidents.
6161+ 2) Consequence: A private, written warning from the Community Moderators.
6262+ 3) Repair: Examples of repair include a private written apology, acknowledgement of responsibility, and seeking clarification on expectations.
6363+2) Temporarily Limited Activities
6464+ 1) Event: A repeated incidence of a violation that previously resulted in a warning, or the first incidence of a more serious violation.
6565+ 2) Consequence: A private, written warning with a time-limited cooldown period designed to underscore the seriousness of the situation and give the community members involved time to process the incident. The cooldown period may be limited to particular communication channels or interactions with particular community members.
6666+ 3) Repair: Examples of repair may include making an apology, using the cooldown period to reflect on actions and impact, and being thoughtful about re-entering community spaces after the period is over.
6767+3) Temporary Suspension
6868+ 1) Event: A pattern of repeated violation which the Community Moderators have tried to address with warnings, or a single serious violation.
6969+ 2) Consequence: A private written warning with conditions for return from suspension. In general, temporary suspensions give the person being suspended time to reflect upon their behavior and possible corrective actions.
7070+ 3) Repair: Examples of repair include respecting the spirit of the suspension, meeting the specified conditions for return, and being thoughtful about how to reintegrate with the community when the suspension is lifted.
7171+4) Permanent Ban
7272+ 1) Event: A pattern of repeated code of conduct violations that other steps on the ladder have failed to resolve, or a violation so serious that the Community Moderators determine there is no way to keep the community safe with this person as a member.
7373+ 2) Consequence: Access to all community spaces, tools, and communication channels is removed. In general, permanent bans should be rarely used, should have strong reasoning behind them, and should only be resorted to if working through other remedies has failed to change the behavior.
7474+ 3) Repair: There is no possible repair in cases of this severity.
7575+7676+This enforcement ladder is intended as a guideline. It does not limit the ability of Community Managers to use their discretion and judgment, in keeping with the best interests of our community.
7777+7878+7979+## Scope
8080+8181+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public or other spaces. Examples of representing our community include using an official email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
8282+8383+8484+## Attribution
8585+8686+This Code of Conduct is adapted from the Contributor Covenant, version 3.0, permanently available at [https://www.contributor-covenant.org/version/3/0/](https://www.contributor-covenant.org/version/3/0/).
8787+8888+Contributor Covenant is stewarded by the Organization for Ethical Source and licensed under CC BY-SA 4.0. To view a copy of this license, visit [https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/)
8989+9090+For answers to common questions about Contributor Covenant, see the FAQ at [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq). Translations are provided at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations). Additional enforcement and community guideline resources can be found at [https://www.contributor-covenant.org/resources](https://www.contributor-covenant.org/resources). The enforcement ladder was inspired by the work of [Mozilla’s code of conduct team](https://github.com/mozilla/inclusion).
+77
docs/contributing.md
···11+For the most up-to-date guide, please see [matrixfurry.com/common](https://tangled.org/@matrixfurry.com/common/blob/main/CONTRIBUTING.md).
22+33+Development happens on [Tangled](https://tangled.org/did:plc:zmjoeu3stwcn44647rhxa44o).
44+55+# Developer Certificate of Origin
66+By submitting code contributions as an individual or on behalf of a corporation to any directory in this repository, you agree to the [Developer Certificate of Origin](./legal/DCO.txt)
77+88+# Reporting issues
99+Yes, issues are contributions.
1010+1111+First, look around in the opened and closed issues, someone might have reported the same issue.
1212+1313+If you're not sure an issue is the same or not, especially an older closed issue, open a new issue and mention that you suspect it could be related.
1414+1515+# Commit guidelines
1616+1717+We follow a similar commit style to Tangled. Please keep your commits:
1818+- **atomic**: each commit should represent one logical change
1919+- **descriptive**: the commit message should clearly describe what the change does and why it's needed
2020+2121+## Message format
2222+We follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) guidelines for commit messages. At present, it's not strictly enforced, but is preferred.
2323+2424+Notes:
2525+- Keep commits lowercased with no trailing period, following the Conventional Commits style.
2626+- Use the imperative mood in the summary line (e.g., "fix bug" not "fixed bug" or "fixes bug").
2727+- Try to keep the summary line under 72 characters.
2828+- Follow the same formatting for PR titles if filled manually.
2929+- Don't include unrelated changes in the same commit (keep commits atomic).
3030+- Avoid noisy commit messages like "wip" or "final fix".
3131+3232+## Commit signing
3333+3434+Commit signing is optional but highly recommended. Once you make your first signed commit, all future commits must be signed.
3535+3636+Please see the [security policy](./security.md) for more information.
3737+3838+## Submitting changes
3939+<!--TODO: Provide more documentation on how pull requests work on Tangled-->
4040+Opening a Pull Request on Tangled is the preferred contribution workflow.
4141+4242+We reccomend using [Jujutsu](https://github.com/jj-vcs/jj) if you're comfortable with it. This way you can take advantage of Tangled's [stacked PRs](https://blog.tangled.org/stacking).
4343+4444+PRs get merged "as-is" (fast-forward) -- like applying a patch-series using `git am`. At present, there is no squashing -- so please author your commits as they would appear on `main`, following the above guidelines. Rewrite history before submitting if necessary.
4545+4646+# "AI"-assisted contributions
4747+> NOTE: Using pre-existing boilerplate, snippets, or syntax suggestions from your IDE or standard Language Server are not considered AI-assisted changes. You're welcome to use those features.
4848+4949+Contributions written largely with help of LLMs (Large Language Models), Generative AI, or similar systems are not welcome.
5050+5151+These systems are generally using statistical models built on content acquired without the author's consent, and with disregard of the content's license and attribution. They also consume a huge amount of energy, and have a very large impact on the environment.
5252+5353+This includes, but is not limited to:
5454+- Comments
5555+- Documentation
5656+- Code
5757+- Issues
5858+- Images, Videos, Audio, or other Assets
5959+6060+Contributions should be largely authored by the people in the commit information, e.g. the `Committer`, `Author`, `Signed-off-by`, and `Co-authored-by` fields.
6161+6262+If you are unsure, or you had help from automated AI-generation in part of your contribution, please tell us when contributing. It does not mean the contribution will be rejected outright. We will evaluate on a case-by-case basis. We value honesty, and take it into consideration.
6363+6464+# Security
6565+Please see the [security policy](./security.md)
6666+6767+# Maintainers
6868+6969+## Releases
7070+We use [Semantic Versioning](https://semver.org/) for our version numbers.
7171+7272+Given a version number `MAJOR.MINOR.PATCH`, increment the:
7373+- `MAJOR` version when you make incompatible API changes
7474+- `MINOR` version when you add functionality in a backward compatible manner
7575+- `PATCH` version when you make backward compatible bug fixes
7676+7777+Additional labels for pre-release and build metadata are available as extensions to the `MAJOR.MINOR.PATCH` format.
+34
docs/legal/DCO.txt
···11+Developer Certificate of Origin
22+Version 1.1
33+44+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
55+66+Everyone is permitted to copy and distribute verbatim copies of this
77+license document, but changing it is not allowed.
88+99+1010+Developer's Certificate of Origin 1.1
1111+1212+By making a contribution to this project, I certify that:
1313+1414+(a) The contribution was created in whole or in part by me and I
1515+ have the right to submit it under the open source license
1616+ indicated in the file; or
1717+1818+(b) The contribution is based upon previous work that, to the best
1919+ of my knowledge, is covered under an appropriate open source
2020+ license and I have the right under that license to submit that
2121+ work with modifications, whether created in whole or in part
2222+ by me, under the same open source license (unless I am
2323+ permitted to submit under a different license), as indicated
2424+ in the file; or
2525+2626+(c) The contribution was provided directly to me by some other
2727+ person who certified (a), (b) or (c) and I have not modified
2828+ it.
2929+3030+(d) I understand and agree that this project and the contribution
3131+ are public and that a record of the contribution (including all
3232+ personal information I submit with it, including my sign-off) is
3333+ maintained indefinitely and may be redistributed consistent with
3434+ this project or the open source license(s) involved.
+67
docs/security.md
···11+For the most up-to-date security policy, please see [matrixfurry.com/common](https://tangled.org/@matrixfurry.com/common/blob/main/docs/security.md).
22+33+# Reporting
44+Please report security issues via [SimpleX](https://smp18.simplex.im/a#Wc2x2IBqqwzgmeGkN0XtKrGMLBxFuxmoYgkTGgGgR0M) or [Email](mailto:shiloh@shilohfen.com).
55+66+> If you want to send an encrypted email, my public key fingerprint is [DD7EB0BAA822169398828C45103DD5193B6A77CB](https://keys.openpgp.org/vks/v1/by-fingerprint/DD7EB0BAA822169398828C45103DD5193B6A77CB).
77+88+Please do not report security issues on the project's issue tracker.
99+1010+# Commit signing
1111+1212+Commit signing is optional but highly recommended. Once you make your first signed commit, all future commits must be signed.
1313+1414+SSH signing is preferred over PGP signing.
1515+1616+To enable signature verification, add your public key to your Tangled profile, and optionally the `.allowed_signers` file in the project's repo.
1717+1818+Tangled profiles should be trusted over the repo's copy, excluding revoked keys.
1919+2020+## Setup
2121+Replace `<YOUR_KEY>` with the SSH key or keyfile you'd like to use (eg. `~/.ssh/id_ed25519`).
2222+2323+Git:
2424+```sh
2525+git config --global gpg.format ssh
2626+git config --global user.signingkey <YOUR_KEY>
2727+git config --global commit.gpgsign true
2828+```
2929+3030+Jujutsu:
3131+```sh
3232+jj config set --user signing.behavior own
3333+jj config set --user signing.backend ssh
3434+jj config set --user signing.key <YOUR_KEY>
3535+```
3636+3737+Add the public key to your Tangled profile at https://tangled.org/settings/keys
3838+3939+Optionally, add your public key to the repo's `.allowed_signers` file:
4040+- Git: `echo "$(git config user.email) $(cat ~/.ssh/id_ed25519.pub)" >> .allowed_signers`
4141+- Jujutsu: `echo "$(jj config get user.email) $(cat ~/.ssh/id_ed25519.pub)" >> .allowed_signers`
4242+4343+## Key Revocation
4444+Revoked keys are listed in `.revoked_keys` ([OpenSSH KRL](https://man.openbsd.org/ssh-keygen.1#KEY_REVOCATION_LISTS) format). Keys must never be reinstated or removed from this file. After a revocation, you must create a new key to continue contributing to the project.
4545+4646+A key revocation must be signed by either:
4747+1. The key being revoked
4848+ - Anyone with access to the private key can create the revocation commit
4949+5050+2. A maintainer with proof of compromise
5151+ - The maintainer must have significant evidence that the key has been compromised
5252+ - The maintainer must attempt to reach out to the contributor to confirm
5353+ - The commit message must provide details of why the key is being revoked
5454+5555+### Instructions
5656+5757+Add the key to the `.revoked_keys` file:
5858+```sh
5959+ssh-keygen -k -u -f .revoked_keys <PUBKEY.pub>
6060+```
6161+6262+View the revoked keys:
6363+```sh
6464+ssh-keygen -Q -l -f .revoked_keys
6565+```
6666+6767+For more information, see the [ssh-keygen(1) manpage](https://man.openbsd.org/ssh-keygen.1#k)
+41
scripts/bottle.nu
···11+#!/usr/bin/env nu
22+# SPDX-License-Identifier: AGPL-3.0-only
33+# SPDX-FileCopyrightText: MatrixFurry <did:plc:zmjoeu3stwcn44647rhxa44o>
44+55+# TODO: Rewrite this in Ruby or Bash so CI doesn't have to install Nushell
66+def main [
77+ formula: string
88+ --token (-t): string # GitLab deploy token
99+ --verbose (-v)
1010+ --no-rebuild (-r)
1111+] {
1212+ cd (mktemp -dt)
1313+1414+ let token = $token | default $env.DEPLOY_TOKEN?
1515+ if ($token | is-empty) {
1616+ error make {
1717+ msg: "Either --token or $env.DEPLOY_TOKEN is required"
1818+ }
1919+ }
2020+2121+ mut bottle_args = []
2222+ mut install_args = []
2323+2424+ if $verbose {
2525+ $install_args ++= ["--verbose"]
2626+ }
2727+2828+ if $no_rebuild {
2929+ $bottle_args ++= ["--no-rebuild"]
3030+ }
3131+3232+ let version = brew info $formula --json | from json | get versions.stable.0
3333+3434+ brew install --build-bottle --bottle-arch "x86-64-v3" ...$install_args $formula
3535+ brew bottle --root-url $"https://gitlab.com/api/v4/projects/75293878/packages/generic/($formula)/($version)" --json ...$bottle_args $formula
3636+ brew bottle --merge --json $"($formula)--($version).x86_64_linux.bottle.json"
3737+3838+ open --raw $"($formula)--($version).x86_64_linux.bottle.tar.gz"
3939+ | into binary
4040+ | http put --content-type application/gzip $"https://gitlab.com/api/v4/projects/75293878/packages/generic/($formula)/($version)/($formula)-($version).x86_64_linux.bottle.tar.gz" -H {DEPLOY-TOKEN: $token}
4141+}