Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,19 @@

The T2 project itself currently does not accept financial donations. However, some of the contributors and maintainers of the project do accept donations on their own. You may refer to the [Support our maintainers](https://wiki.t2linux.org/contribute/#support-our-maintainers) section of this page to get the links of the same.

The best way of donation which we believe is in the form of skill. If you think you have the potential to help us in pushing the project further like fixing bugs, adding new features etc., you are free to do so. For this, you may contact our discord server, where other members of this organization are present.
The best way to donate, we believe, is in the form of skill. If you think you have the potential to help us in pushing the project further, like fixing bugs, adding new features, etc., you are free to do so. For this, you may contact our Discord server, where other members of this organization are present.

## Contribute to the code

See "partially working" features at [State](https://wiki.t2linux.org/state/) to get an idea of what's being worked on, and what should be worked on.

## Support our maintainers

Here is the list and links to donate some of our maintainers.
Here is the list and links to donate to some of our maintainers.

- [MCMrARM](https://github.com/MCMrARM) - Author of the [apple-bce driver](https://github.com/t2linux/apple-bce-drv). Donate via [Paypal](https://paypal.me/mcmrarm).
- [JPyke3](https://github.com/JPyke3) - Played major role in getting Manjaro working on T2 Macs. Donate via [Patreon](https://patreon.com/pykee) or [On Chain](https://github.com/JPyke3/mbp-manjaro#donations).
- [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad).
- [JPyke3](https://github.com/JPyke3) - Played a major role in getting Manjaro working on T2 Macs. Donate via [Patreon](https://patreon.com/pykee) or [On Chain](https://github.com/JPyke3/mbp-manjaro#donations).
- [marcosfad](https://github.com/marcosfad) - Played a major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad).
- [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images and kernels for Arch and EndeavourOS. Donate via [GitHub Sponsors](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuruverse).
- [Redecorating](https://github.com/Redecorating) - Played a major role in adding support for T2 Macs in the apple-gmux driver, required for hybrid graphics. Also has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal](https://paypal.me/redecorating).
- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **Buy Me a Coffee** ([Link](https://www.buymeacoffee.com/gargadityav)).
Expand Down
4 changes: 2 additions & 2 deletions docs/distributions/arch/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
You will need:

- USB drive with at least 1GB
- A way to plug it into your Mac (USB-C isn't USB-A)
- A way to plug it into your Mac (USB-C and USB-A are different)

---

!!! Warning "Users in NA/EU might face slow download speeds from the mirror"
If you're experiencing slow download speed or failure to install, please edit your `/etc/pacman.conf` file and replace old mirror.funami.tech link with `https://github.com/NoaHimesaka1873/arch-mact2-mirror/releases/download/release` instead. You can also checkout the [arch-mirrors mailing list](https://lists.archlinux.org/archives/list/arch-mirrors@lists.archlinux.org/) to get information about latest downtimes for mirror.funami.tech.
If you're experiencing slow download speeds or installation failures, please edit your `/etc/pacman.conf` file and replace the old mirror.funami.tech link with `https://github.com/NoaHimesaka1873/arch-mact2-mirror/releases/download/release` instead. You can also checkout the [arch-mirrors mailing list](https://lists.archlinux.org/archives/list/arch-mirrors@lists.archlinux.org/) to get information about latest downtimes for mirror.funami.tech.

1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps.

Expand Down
10 changes: 5 additions & 5 deletions docs/distributions/debian/installation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Introduction

This guide shall help you in installing a Debian or Ubuntu based Linux distro, which is not available as a modified ISO with T2 support.
This guide will help you install a Debian or Ubuntu based Linux distro, which is not available as a modified ISO with T2 support.

Some popular distros include:

Expand Down Expand Up @@ -32,9 +32,9 @@ Some popular distros include:

2. The partition to be made compulsorily is the one mounted at `/` and formatted to **ext4** or **btrfs**.

3. If the installer used by your distro is `ubiquity`, which is the one used in Ubuntu, Linux Mint etc., then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed).
For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the "boot" flag, set it as well for your EFI partition.
3. If the installer used by your distro is `ubiquity` (which is the one used in Ubuntu, Linux Mint, etc.), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-separate-efi-partitions), then you will have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#separate-the-efi-partition-after-linux-is-installed).

For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-separate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the "boot" flag, set it as well for your EFI partition.

5. Continue the rest of the setup.
6. Once it's finished, you can reboot without your installation media. Hold down Option (⌥) while booting, then select EFI Boot and press enter.
Expand Down Expand Up @@ -71,4 +71,4 @@ After installation, we need to install a kernel having patches to support the T2

# Basic set up

After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You shall mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. Rest have been set up automatically by the kernel upgrade script.
After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You will mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-parameters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. Rest have been set up automatically by the kernel upgrade script.
8 changes: 4 additions & 4 deletions docs/distributions/endeavouros/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@
You will need:

- USB drive with at least 4GB
- A way to plug it into your Mac (USB-C isn't USB-A)
- A wired internet connection (i.e. USB-C to Enternet dongle) or Wi-Fi.
- A way to plug it into your Mac (USB-C and USB-A are different)
- A wired internet connection (i.e. USB-C to Ethernet dongle) or Wi-Fi.

---

!!! Warning "Users in NA/EU"
If you're experiencing slow download speed or failure to install, please edit your `/etc/pacman.conf` file and replace old mirror.funami.tech link with `https://github.com/NoaHimesaka1873/arch-mact2-mirror/releases/download/release` instead.
If you're experiencing slow download speeds or installation failures, please edit your `/etc/pacman.conf` file and replace the old mirror.funami.tech link with `https://github.com/NoaHimesaka1873/arch-mact2-mirror/releases/download/release` instead.

1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for the installation.

Expand All @@ -26,7 +26,7 @@ You will need:
3. Follow the installer until Partitions.

1. Select "Manual partitioning."
2. Select "/dev/nvme0n1p1" partition, make sure the "boot" flag is set, and set it to mount under "/efi". If you want to use separate EFI partition, check out [this guide](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions).
2. Select "/dev/nvme0n1p1" partition, make sure the "boot" flag is set, and set it to mount under "/efi". If you want to use separate EFI partition, check out [this guide](https://wiki.t2linux.org/guides/windows/#using-separate-efi-partitions).
3. Use remaining partition space to your convenience.

4. Follow the rest of the installer and reboot.
Expand Down
2 changes: 1 addition & 1 deletion docs/distributions/fedora/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ If you already have Bootcamp installed, you might notice that the boot option fo

This may be due to differences between USB-C to USB-A adapters. Try a different one if it is not working.

# My touchbar is blank
# My Touch Bar is blank

Follow the instructions in the [post-install guide](https://wiki.t2linux.org/guides/postinstall/#setting-up-the-touch-bar). If it still is not working, try updating your macOS installation.

Expand Down
2 changes: 1 addition & 1 deletion docs/distributions/fedora/home.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Welcome to the T2 Fedora wiki!

Follow [the installation guide](https://wiki.t2linux.org/distributions/fedora/installation/) to get started. If you need help, join the t2linux discord [server](https://discord.com/invite/68MRhQu) server and ask in `#fedora` over there. Alternately, you can open an issue in the github [issue tracker](https://github.com/t2linux/wiki/issues). You can also refer to the [FAQ](https://wiki.t2linux.org/distributions/fedora/faq/) to fix common problems.
Follow [the installation guide](https://wiki.t2linux.org/distributions/fedora/installation/) to get started. If you need help, join the t2linux Discord [server](https://discord.com/invite/68MRhQu) and ask in `#fedora`. Alternatively, you can open an issue in the GitHub [issue tracker](https://github.com/t2linux/wiki/issues). You can also refer to the [FAQ](https://wiki.t2linux.org/distributions/fedora/faq/) to fix common problems.
4 changes: 2 additions & 2 deletions docs/distributions/fedora/installation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Download the latest safe release

Many thanks to [Mike](https://github.com/mikeeq/) for building. You can download a live iso from [here](https://github.com/t2linux/fedora-iso/releases).
Many thanks to [Mike](https://github.com/mikeeq/) for building. You can download a live ISO from [here](https://github.com/t2linux/fedora-iso/releases).

# Hardware Requirements

Expand All @@ -14,7 +14,7 @@ Many thanks to [Mike](https://github.com/mikeeq/) for building. You can download
4. Continue with the rest of the installation.
5. Once it's finished, you can reboot without your installation media. Hold down Option (⌥) while booting, then select EFI Boot and press enter.
6. Welcome to Fedora! :)
7. Wi-Fi should work on first boot, but if it is not you should follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/).
7. Wi-Fi should work on first boot, but if it does not, you should follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/).

## Installing unsupported spins

Expand Down
6 changes: 3 additions & 3 deletions docs/distributions/gentoo/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
## Install Procedure

1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps.
1. Since there is not yet a T2 Gentoo Installation ISO, you will need to use a different ISO. We recommend the [T2-Ubuntu](https://github.com/t2linux/T2-Ubuntu/releases/latest) ISO if you want a graphical environment, or the [T2-Archiso](https://github.com/t2linux/archiso-t2/releases/latest) if you don't want to have to copy Wi-Fi firmware to the livecd.
1. Since there is not yet a T2 Gentoo installation ISO, you will need to use a different ISO. We recommend the [T2-Ubuntu](https://github.com/t2linux/T2-Ubuntu/releases/latest) ISO if you want a graphical environment, or the [T2-Archiso](https://github.com/t2linux/archiso-t2/releases/latest) if you don't want to have to copy Wi-Fi firmware to the livecd.
2. If you chose the Ubuntu ISO, follow the [Wi-Fi Guide](https://wiki.t2linux.org/guides/wifi-bluetooth/) once booted.

2. Connect to the internet using NetworkManager in the Ubuntu ISO, or using `iwctl` in the Arch ISO.

3. You will need to reformat your partitions, except for the EFI partition. The other partitions will need to reformatted as described in the [Gentoo Handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Disks). For the EFI system partition there will be one at `/dev/nvme0n1p1` and you can use this if you don't intend to install Windows or already have it installed. If you do intend to triple boot, refer to [this guide](https://wiki.t2linux.org/guides/windows/).
3. You will need to reformat your partitions, except for the EFI partition. The other partitions will need to be reformatted as described in the [Gentoo Handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Disks). For the EFI system partition there will be one at `/dev/nvme0n1p1` and you can use this if you don't intend to install Windows or already have it installed. If you do intend to triple boot, refer to [this guide](https://wiki.t2linux.org/guides/windows/).

4. Follow the Gentoo Handbook from [Installing stage3](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Stage) until [Kernel Configuration and Compilation](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Kernel#Kernel_configuration_and_compilation).

Expand All @@ -27,7 +27,7 @@

1. The T2 overlay provides a [Distribution Kernel](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Kernel#Distribution_kernels) for T2 Macs. To install it, run `emerge -av sys-kernel/t2gentoo-kernel`.

2. Alternatively, you can use the kernel sources and manually compile. With this method, the update process is not automated, and manual configuration is necessary. However, `sys-kernel/t2gentoo-sources` tends to get new kernel versions faster then `sys-kernel/t2gentoo-kernel`. To install it, run: `emerge -av sys-kernel/t2gentoo-sources`. After installing the kernel sources, run `eselect kernel set 1` to point `/usr/src/linux` to the correct path, then follow the directions in the [Manual Configuration](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Kernel#Alternative:_Manual_configuration) section of the handbook. If you decide to manually configure your kernel, make sure the following options are set:
2. Alternatively, you can use the kernel sources and manually compile. With this method, the update process is not automated, and manual configuration is necessary. However, `sys-kernel/t2gentoo-sources` tends to get new kernel versions faster than `sys-kernel/t2gentoo-kernel`. To install it, run: `emerge -av sys-kernel/t2gentoo-sources`. After installing the kernel sources, run `eselect kernel set 1` to point `/usr/src/linux` to the correct path, then follow the directions in the [Manual Configuration](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Kernel#Alternative:_Manual_configuration) section of the handbook. If you decide to manually configure your kernel, make sure the following options are set:

```bash
CONFIG_APPLE_BCE=m
Expand Down
8 changes: 1 addition & 7 deletions docs/distributions/manjaro/deprecation.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,8 @@
# Why is Manjaro T2 deprecated?

Due to [concerns](https://github.com/arindas/manjarno), Manjaro T2 is deprecated.
If you want to maintain it yourself, come to our Discord and we will help.
If you want to maintain it yourself, come to our Discord and we will help you.

# What distro should I use instead?

We recommend [EndeavourOS.](https://wiki.t2linux.org/distributions/endeavouros/installation/)

# What do I do after Manjaro is deprecated?

No support for installation will be provided starting from 2023. If you want to install Manjaro on your Mac after 2023, you're on your own.

For kernel for existing installation, until the end of 2023. LTS will be supported longer for those who can't switch for whatever reason.
4 changes: 2 additions & 2 deletions docs/distributions/manjaro/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ After running this, remove old repository and reboot.

# Upgrading to newer kernel (recommended)

Users using older kernel are advised to migrate to newest kernel since newer kernel has more support.
Users using older kernels are advised to migrate to the newest kernel since the newer kernel has more support.

Join our Discord or enable notifications for [this repository](https://github.com/NoaHimesaka1873/manjaro-kernel-t2) to get pings for new kernel.
Join our Discord or enable notifications for [this repository](https://github.com/NoaHimesaka1873/manjaro-kernel-t2) to get pings for new kernels.

# Installing alongside Windows

Expand Down
4 changes: 2 additions & 2 deletions docs/distributions/manjaro/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@

Manjaro T2 support is deprecated. See [Deprecation Plan](https://wiki.t2linux.org/distributions/manjaro/deprecation) for more information.

# Download a latest release
# Download the latest release

[See releases](https://github.com/NoaHimesaka1873/manjaroiso-t2/releases)

# Hardware Requirements

* USB-C to Ethernet cable adapter.
* While you can install Manjaro over WiFi, it would be a lot easier to use an Adapter during the installation process.
* While you can install Manjaro over WiFi, it would be a lot easier to use an adapter during the installation process.
* USB-C to USB Adapter
* USB drive

Expand Down
2 changes: 1 addition & 1 deletion docs/distributions/nixos/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

## The LiveCD does not boot/only shows a blank screen

This situation occurred due to regressions in the bootloader, which the wider NixOS community was also affected.
This situation occurred due to regressions in the bootloader, which also affected the wider NixOS community.
The bug has been fixed. Make sure you are using ISOs tagged at or newer than `6.4.9-2`. Nevertheless, usage of [the latest ISO](https://github.com/t2linux/nixos-t2-iso/releases/latest) is recommended.

## In the Live environment, building the kernel/configuration runs out of disk space
Expand Down
2 changes: 1 addition & 1 deletion docs/distributions/nixos/home.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ If you have any questions, consult the [FAQ](./faq.md) to see if anything there

## New to NixOS?

NixOS is not exactly an easy Linux distribution to use. If you are entirely new to Linux or had no prior experience with Nix, we strongly recommend you choose another distro like [Fedora](../fedora/home.md) first. Should you decide to proceed further, the [Nixpkgs manual](https://nixos.org/manual/nixpkgs/unstable), [Zero-to-Nix](https://zero-to-nix.com/), [NixOS Options Search](https://search.nixos.org/options) and [the official Nix wiki](https://nix.dev) could come in handy.
NixOS is not exactly an easy Linux distribution to use. If you are entirely new to Linux or have no prior experience with Nix, we strongly recommend you choose another distro like [Fedora](../fedora/home.md) first. Should you decide to proceed further, the [Nixpkgs manual](https://nixos.org/manual/nixpkgs/unstable), [Zero-to-Nix](https://zero-to-nix.com/), [NixOS Options Search](https://search.nixos.org/options) and [the official Nix wiki](https://nix.dev) could come in handy.

Note that since T2 devices require kernel patches, you will need to build the Linux kernel quite often. This can be circumvented by [using a substituter.](faq.md#substituter-setup)

Expand Down
Loading