HomeMenuNX

A WIP Home Menu replacement for the Nintendo Switch, inspired by XorTrolls uLaunch.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Contact
• Credits

About The Project

HomeMenuNX tries to give the user a simple yet powerful design that feels intuitive to use, while also trying to be as customizable as possible.

Built With

• devkitPro
• libNX
• SDL2

Getting Started

You can either download the latest release, which is tested and guaranteed to work, or compile it from source yourself. If you want to compile for yourself, please follow the instructions below.

Prerequisites

You need devkitPro in order to compile this, along with libnx and SDL2. To install all of them, follow the instructions for installing devkitPro from the official installation guide at: https://github.com/devkitPro/pacman/releases/tag/v1.0.2 After you install (dkp-)pacman successfully, run the command below to install the sdl2 dependencies

sudo dkp-pacman -S switch-sdl2 switch-sdl2_gfx switch-sdl2_image switch-sdl2_mixer switch-sdl2_net switch-sdl2_ttf

Please also make sure that you have the build-essentials (make etc.) to avoid any errors.

Compile

1. Clone the repo

git clone https://github.com/5H4D0WILA/HomeMenuNX.git

2. run make to compile

make

Usage

To use this replacement, just copy the .nro file to your switch folder and run it through hb_menu

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project Link: https://github.com/5H4D0WILA/HomeMenuNX

Credits

Without these people this project would be impossible.

• libertea - for figuring out how to create the rounded corners
• XorTroll - For giving me the inspiration to create this and helping me when i am stuck
• MasaGratoR - also for helping me when i am stuck and giving me the code for getting the titles installed on the system
• devkitPro - without the team of devkitPro it would be impossible for projects like these to exist