uLaunch/README.md

111 lines
5 KiB
Markdown
Raw Normal View History

<img width="200" src="LibraryAppletDaemon/RomFs/LogoLarge.png">
2019-10-05 20:44:05 +00:00
2019-11-23 13:32:29 +00:00
> Custom, open-source replacement/reimplementation for Nintendo Switch's HOME menu (qlaunch), extending it with amazing, homebrew-oriented functionality!
2019-10-14 18:04:44 +00:00
2019-11-09 18:43:54 +00:00
<img src="Screenshots/s1.png" alt="drawing" width="400"/> <img src="Screenshots/s2.png" alt="drawing" width="400"/>
2019-11-09 23:09:25 +00:00
<img src="Screenshots/s3.png" alt="drawing" width="400"/> <img src="Screenshots/s4.png" alt="drawing" width="400"/>
2019-11-09 18:43:54 +00:00
<img src="Screenshots/s5.png" alt="drawing" width="400"/> <img src="Screenshots/s6.png" alt="drawing" width="400"/>
2019-11-23 13:32:29 +00:00
uLaunch is a very ambitious project, consisting on two custom library applets, a custom system application and a custom system applet, in order to replace the console's **HOME menu** with a custom, homebrew-oriented one.
2019-10-05 20:44:05 +00:00
2019-11-10 16:23:35 +00:00
- This isn't any kind of HOME menu extension, injection, patch, etc. uLaunch is a **complete** reimplementation, 100% open-source, which also takes over eShop and Parental control applets and flog system title (all of them are pretty much useless with this reimpl) for its extended functionality.
2019-10-05 20:44:05 +00:00
2019-10-14 18:04:44 +00:00
- The project is licensed as **GPLv2**.
- For those who are interested in how the UI was done, this project is, like [Goldleaf](https://github.com/XorTroll/Goldleaf), a good example of how powerful [Plutonium libraries](https://github.com/XorTroll/Plutonium) can be in order to make beautiful UIs.
2019-11-23 13:32:29 +00:00
## Get it from [here](https://github.com/XorTroll/uLaunch/releases/latest)!
### Want to create **custom forwarders** (eg. RetroArch ones)? check **uViewer** tool in [latest releases](https://github.com/XorTroll/uLaunch/releases/latest)!
### Want to find **themes** for uLaunch? Check [r/uLaunchThemes subreddit](https://www.reddit.com/r/uLaunchThemes/)!
### For more detailed **information** about the whole project (*themeing* too), check its [wiki](https://github.com/XorTroll/uLaunch/wiki)!
2019-10-05 20:44:05 +00:00
2019-10-12 23:26:30 +00:00
## Features
2019-10-05 20:44:05 +00:00
2019-11-10 16:23:35 +00:00
**List of HOME menu features uLaunch has**:
- Proper launching and foreground management: launch, suspend and close titles and applets
- Proper general channel handling (some of it might be not implemented): sleep, shutdown, reboot, HOME menu press detection...
- Settings:
2020-03-20 23:49:57 +00:00
- Show connected WiFi network's name, MAC and IP address...
2019-11-10 16:23:35 +00:00
- Open connection applet in case user wants to change network settings
- Change console's language and show active one
- Change console's nickname and show current one
- User features:
- Allow creating user on the startup menu
- Show user's page (in order to edit nickname, icon, friends...)
- *Homebrew support*
2019-10-12 23:26:30 +00:00
- Launching as applets (no need of **Album**!)
- Launching as **applications** (no need of **any titles** to do so!)
- Custom basic homebrew menu
2019-10-28 18:12:34 +00:00
- Option to add custom NRO accessors to main menu (homebrew or custom items easily accessible, no more need of **forwarders**!)
2019-10-12 23:26:30 +00:00
2019-11-10 16:23:35 +00:00
- *UI*
2019-10-12 23:26:30 +00:00
2019-10-28 18:12:34 +00:00
- **Themes** (different to official HOME menu themes/NXThemes)
2019-10-12 23:26:30 +00:00
2019-11-10 16:23:35 +00:00
- Custom icons, menu assets and graphics (custom images, colors, sizes, positions...), background...
2019-10-12 23:26:30 +00:00
- Custom **background music** and **sound effects**!
2019-10-28 18:12:34 +00:00
- **Folders** in order to keep your main menu organized!
2019-11-10 16:23:35 +00:00
- *Users*
2019-10-12 23:26:30 +00:00
2019-10-28 18:12:34 +00:00
- PC-like login on startup (select user and use it for everything, log off, register/change/remove password...)
2019-10-12 23:26:30 +00:00
2019-10-28 18:12:34 +00:00
- **User password** support! (up to 15 characters)
2019-10-12 23:26:30 +00:00
2019-11-10 16:23:35 +00:00
- *Miscellaneous extras*
- Web browsing (via web-applet) directly from the main menu!
2019-11-23 13:32:29 +00:00
- **Console screen capturing** from PC itself (*Windows*-only) via USB-C cable and *uViewer* tool!
2019-11-10 16:23:35 +00:00
2019-10-12 23:26:30 +00:00
## Disclaimer
### Homebrew-as-application 'flog' takeover
2019-10-12 23:26:30 +00:00
2019-11-10 16:23:35 +00:00
uLaunch allows you to launch homebrew as an application, taking advantage of the system's '**flog**' built-in application title, which was stubbed but not removed, thus it's content can be overriden via LayeredFS and launched.
Since launching this title should be impossible, it might involve ban risk. uLaunch has this option **disabled by default**, so enable and use it **use it at your own risk**. Always make youre you're safe from bans (by using tools like 90DNS) before using uLaunch to avoid any possible risks.
2019-10-12 23:26:30 +00:00
## Compiling
You will need devkitPro, devkitA64, libnx and all SDL2 libraries for switch development.
2020-06-05 20:37:21 +00:00
Clone (**recursively!**) this repo (uses Atmosphere-libs and Plutonium submodules) and hit `make` in root. It should build everything and generate a `titles` folder ready for use inside `SdOut`.
2019-10-14 18:04:44 +00:00
2020-06-05 20:37:21 +00:00
In order to only build a certain subproject, you can run `make` plus the subproject's name (`make daemon`, `make hbtarget` or `make menu`).
2019-11-10 16:23:35 +00:00
2019-10-12 23:26:30 +00:00
## Credits
2020-06-05 20:37:21 +00:00
- SciresM for [Atmosphere-libs](https://github.com/Atmosphere-NX/Atmosphere-libs).
2019-10-12 23:26:30 +00:00
2019-11-23 13:32:29 +00:00
- Switchbrew team for libnx and [nx-hbloader](https://github.com/switchbrew/nx-hbloader), the base of *QHbTarget processes (they're just simple wrappers of hbloader in the end)
2019-10-23 19:49:30 +00:00
- C4Phoenix for the amazing design of this project's logo.
2019-11-10 16:23:35 +00:00
- [Icons8](https://icons8.com/) website for a big part of the icons used by the default style.
2019-11-23 13:32:29 +00:00
- Several scene developers for their help with small issues or features.
2019-11-10 16:23:35 +00:00
- Everyone from Discord or other places whose suggestions made this project a little bit better :)