Skip to content

Commit

Permalink
Add instructions for tiny-dfr on Ubuntu
Browse files Browse the repository at this point in the history
  • Loading branch information
AdityaGarg8 committed Oct 14, 2023
1 parent 242bfa5 commit da6c826
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 13 deletions.
8 changes: 8 additions & 0 deletions docs/distributions/debian/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,14 @@ After installation, we need to install a kernel having patches to support the T2

7. Follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/) to get internal Wi-Fi working.

8. If your Mac has a Touch Bar, install `tiny-dfr` by running:

```bash
sudo apt install tiny-dfr
```

**Note:** Make sure you restart your Mac after installing `tiny-dfr`. In order to configure your Touch Bar, run `sudo touchbar` and follow the on-screen instructions.

# 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.
6 changes: 6 additions & 0 deletions docs/distributions/ubuntu/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,12 @@

In order to continue receiving the kernel updates for T2 kernels, it's recommended to set up the kernel update script as described [here](https://github.com/t2linux/T2-Ubuntu-Kernel#using-the-kernel-upgrade-script).

# Configuring the Touch Bar

If your Mac has a Touch Bar, then you can install the `tiny-dfr` app by running `sudo apt update && sudo apt install tiny-dfr` to set up the Touch Bar. Make sure you restart your Mac after installing the app.

For configuration of the Touch Bar, run `sudo touchbar` and follow the on-screen instructions.

# Troubleshooting

If you are facing issues while installing or have post installation issues (E.g.: Wi-Fi, sound etc.), refer to the [FAQ](https://wiki.t2linux.org/distributions/ubuntu/faq/) section first. If it is not able to help you, you may open an issue [here](https://github.com/t2linux/T2-Ubuntu/issues) or contact us on the [Discord server](https://discord.com/invite/68MRhQu).
24 changes: 11 additions & 13 deletions docs/guides/postinstall.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,24 +90,22 @@ The steps to be followed vary depending upon the initramfs module loading mechan

## Setting up the Touch Bar

The Touch Bar can be set up by running [this script](../tools/touchbar.sh) **in Linux** using `bash /path/to/script`. Make sure your Linux kernel and macOS is updated before running this script.
Setting up the Touch Bar is different for Ubuntu and Debian based distros.

If you want to try something new and you're using Arch Linux, EndeavourOS, or Manjaro, you could install `touchbard` package and use that instead. For more information, visit [touchbard repository](https://github.com/NoaHimesaka1873/touchbard).
If you are using an Ubuntu or Debian based distro:

After running this script, if you wish to change the default mode of the Touch Bar, run `sudo touchbar` and choose the mode you wish.
1. Add the apt repo for T2 Macs from [here](https://github.com/AdityaGarg8/t2-ubuntu-repo.git).
2. Install `tiny-dfr` by running `sudo apt install tiny-dfr`.
3. Restart your Mac.
4. After restarting, you can run `sudo touchbar` to get a list of options that you can configure. Simply follow the on-screen instructions.

In case your Touch Bar is unable to change modes on pressing the fn key, you could try the following:
For other distros:

- Try running the following and rebooting.

```sh
echo -e "# delay loading of the touchbar driver\ninstall apple-touchbar /bin/sleep 7; /sbin/modprobe --ignore-install apple-touchbar" | sudo tee /etc/modprobe.d/delay-tb.conf >/dev/null
```

- Boot into the [macOS Recovery](https://support.apple.com/en-gb/HT201314) and then restart into Linux.
- Unplug all the external USB keyboards and mouse and then restart into Linux, keeping them unplugged.
- The Touch Bar can be set up by running [this script](../tools/touchbar.sh) **in Linux** using `bash /path/to/script`. Make sure your Linux kernel and macOS is updated before running this script.

Check failure on line 104 in docs/guides/postinstall.md

View workflow job for this annotation

GitHub Actions / lint

Unordered list indentation [Expected: 0; Actual: 2]

If you still face an issue, mention it [here](https://github.com/t2linux/wiki/issues) or on the discord.
- After running this script, if you wish to change the default mode of the Touch Bar, run `sudo touchbar` and choose the mode you wish.

Check failure on line 106 in docs/guides/postinstall.md

View workflow job for this annotation

GitHub Actions / lint

Unordered list indentation [Expected: 0; Actual: 2]

- If you want to try something new and you're using Arch Linux, EndeavourOS, or Manjaro, you could install `touchbard` package and use that instead. For more information, visit [touchbard repository](https://github.com/NoaHimesaka1873/touchbard).

Check failure on line 108 in docs/guides/postinstall.md

View workflow job for this annotation

GitHub Actions / lint

Unordered list indentation [Expected: 0; Actual: 2]

# Wi-Fi and Bluetooth

Expand Down

0 comments on commit da6c826

Please sign in to comment.