-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
11 changed files
with
201 additions
and
38 deletions.
There are no files selected for viewing
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,81 @@ | ||
| # Root your TV | ||
|
|
||
| ## Root or Not? | ||
|
|
||
| Before rooting your TV, please think about what you would like to do with a rooted TV. | ||
|
|
||
| | Use Case | Root Required | | ||
| |-------------------------------------------------|---------------| | ||
| | Using Kodi | No | | ||
| | Stream PC games with Moonlight | No | | ||
| | Amblight setup | Yes | | ||
| | Remapping remote control buttons | Yes | | ||
| | Keeping Kodi's `.kodi` directory on a USB drive | Yes | | ||
|
|
||
| Use Kodi? That doesn't require root. | ||
|
|
||
| Stream PC games with Moonlight? That doesn't require root either. | ||
|
|
||
| For many uses, like installing some useful homebrew applications, root is **NOT** required. | ||
| Using developer mode is enough most of the time and not hard to set up either. | ||
| It requires an account though, and you'll have to renew the developer mode every | ||
| 1000 hours. | ||
|
|
||
| However, an Amblight setup with | ||
| [PicCap](https://github.com/TBSniller/piccap)/[Hyperion](https://github.com/webosbrew/hyperion-webos)/[HyperHDR](https://github.com/webosbrew/hyperhdr-webos-loader) | ||
| *will* require root. | ||
|
|
||
| Remapping remote control buttons with [lginputhook](https://github.com/Simon34545/lginputhook) requires root. | ||
|
|
||
| Keeping Kodi's `.kodi` directory on a USB drive also requires root. | ||
|
|
||
| > [!NOTE] | ||
| > Highlights information that users should take into account, even when skimming. | ||
| > [!TIP] | ||
| > Optional information to help a user be more successful. | ||
| > [!IMPORTANT] | ||
| > Crucial information necessary for users to succeed. | ||
| > [!WARNING] | ||
| > Critical content demanding immediate user attention due to potential risks. | ||
| > [!CAUTION] | ||
| > Negative potential consequences of an action. | ||
| ### Benefits of Rooting | ||
|
|
||
| * No developer mode needed anymore - No need to worry about the dev mode timer or an LG account | ||
| * Gain more control over your TV - Block ads and auto-updates | ||
| * Increase privacy - Disable telemetry | ||
| * More modifications - Custom wallpaper, screensaver, ambient lighting, etc. | ||
| * Access webOS internals - Useful for researching and exploring the Linux system underlying webOS | ||
|
|
||
| ### Caveats of Rooting | ||
|
|
||
| * Methods may get patched by LG - If you apply firmware updates, you may lose any homebrew apps and mods you've | ||
| installed | ||
| * Rooting is safe, but reckless changes are not - You could brick your TV if you don't have proper knowledge and ignore | ||
| **[warnings](https://rootmy.tv/warning)** | ||
|
|
||
| ## How Do I Use Homebrew Apps Without Root? | ||
|
|
||
| Using [dev-manager-desktop](https://github.com/webosbrew/dev-manager-desktop) makes this pretty easy. | ||
|
|
||
| <img src="https://user-images.githubusercontent.com/830358/215523117-0fdbde24-a503-4eed-8e2f-50a3486ce7f7.png" alt="Install from webOS Homebrew repo" title="Install from webOS Homebrew repo" width="70%"> | ||
|
|
||
| ## I Want Root Anyway! | ||
|
|
||
| As of February 2024, LG has released multiple patches for the vulnerabilities we found. | ||
| Depending on the firmware and model, there are multiple approaches to rooting a webOS TV. | ||
|
|
||
| - [RootMy.TV](https://rootmy.tv/) - For webOS 3.4 and up, but very likely patched (read | ||
| the [README](https://github.com/RootMyTV/RootMyTV.github.io?tab=readme-ov-file#readme) first!) | ||
| - [crashd](https://gist.github.com/throwaway96/e811b0f7cc2a705a5a476a8dfa45e09f) - For webOS 4.0 and up; patches being | ||
| rolled out | ||
| - [WTA](https://gist.github.com/throwaway96/b171240ef59d7f5fd6fb48fc6dfd2941) - For webOS 5 and up; patches being rolled | ||
| out | ||
| - [DEBUG via NVM](https://gist.github.com/throwaway96/827ff726981cc2cbc46a22a2ad7337a1) - Works on all webOS versions | ||
| prior to 4.0 (plus NetCast/GP) but requires opening up the TV (no permanent hardware modifications) | ||
| - GetMeIn - May work on webOS up to 3.4 on certain models, but don't use the original binary from the XDA thread |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| <!doctype html> | ||
| <html lang="en"> | ||
| <head> | ||
| <meta charset="utf-8"> | ||
| <meta name="viewport" content="width=device-width, initial-scale=1"> | ||
| <title>{{title}} | webOS Homebrew</title> | ||
| <link href="../../scss/styles.scss" rel="stylesheet"> | ||
| <link href="@img/hbchannel-color.svg" type="image/svg" rel="icon"> | ||
| </head> | ||
| <body data-bs-theme="dark"> | ||
| {{> navbar }} | ||
| <main class="bg-dark-subtle"> | ||
| <div class="container py-4"> | ||
| {{markdown (include page)}} | ||
| </div> | ||
| </main> | ||
| {{> footer }} | ||
| </body> | ||
| </html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters