diff --git a/README.md b/README.md index f5bd4fc..919b35b 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,62 @@ # Homebrew App Store + [![GPLv3 License](https://img.shields.io/badge/license-GPLv3-blue.svg?style=flat-square)](https://opensource.org/licenses/GPL-3.0) [![gh actions](https://img.shields.io/github/actions/workflow/status/fortheusers/hb-appstore/main.yml?style=flat-square)](https://github.com/fortheusers/hb-appstore/actions/workflows/main.yml) [![gitlab ci](https://gitlab.com/4TU/hb-appstore/badges/master/pipeline.svg?style=flat-square)](https://gitlab.com/4TU/hb-appstore/pipelines) [![discord](https://img.shields.io/discord/339118412414582786.svg?color=blueviolet&label=discord&style=flat-square)](https://discordapp.com/invite/F2PKpEj) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome!-tomato.svg?style=flat-square)](http://makeapullrequest.com) -A [Chesto](https://github.com/fortheusers/chesto)-based graphical frontend to the [get package manager](https://github.com/fortheusers/libget) for downloading and managing homebrew on video game consoles, such as the Nintendo Switch and Wii U. This is a replacement to the older [Wii U Homebrew App Store](https://github.com/vgmoose/wiiu-hbas). +The Homebrew App Store is a GUI that can be used to access an online repository of open-source [homebrew apps](https://en.wikipedia.org/wiki/Homebrew_(video_games)). It's written in [SDL2 with Chesto](https://github.com/fortheusers/chesto) and uses the [get package manager](https://github.com/fortheusers/libget) to download and manage open-source apps. ## Supported Platforms -### Nintendo Switch -To run this program, a Nintendo Switch with access to the Homebrew Menu is required. This can be done on most Switches manufactured before July 2018, for compatibility check your serial number at [ismyswitchpatched.com](https://ismyswitchpatched.com). To run hbmenu, see the tutorial [here](https://guide.sdsetup.com/). -Download and extract the latest [hb-appstore](https://github.com/fortheusers/hb-appstore/releases) to `sd:/switch/appstore/`, and run "HB App Store" from within hbmenu. When you're done, you can press the Home or Minus buttons to exit. +### Desktop (Linux, Mac, Windows) +Standalone PC executables are available from [the nightlies](https://nightly.link/fortheusers/hb-appstore/workflows/pc-builds/main). These PC clients download and extract files to an `sdroot` folder relative to the app's path. + +### Web Browsers +A web interface to download files from the Homebrew App Store directly is available at [apps.fortheusers.org](https://apps.fortheusers.org). Source code: [hbas-frontend](https://github.com/fortheusers/hbas-frontend). + +### Wii U +The ability to run homebrew apps is required. Download and extract the latest [hb-appstore](https://github.com/fortheusers/hb-appstore/releases) to `sd:/wiiu/apps/appstore/`, and run "HB App Store" either from the home menu or the Homebrew Launcher. -### Nintendo Wii U -To run this program, a modded Wii U is required. This can be done on any console or firmware, but for a compatibility check anyway, see [ismywiiupatched.com](https://ismywiiupatched.com). To run the Homebrew Launcher, see the tutorial [here](https://wiiuguide.xyz/). +### Switch +Access to the Homebrew Menu is required. Download and extract the latest [hb-appstore](https://github.com/fortheusers/hb-appstore/releases) to `sd:/switch/appstore/`, and run "HB App Store" from within hbmenu. -Download and extract the latest [hb-appstore](https://github.com/fortheusers/hb-appstore/releases) to `sd:/wiiu/apps/appstore/`, and run "HB App Store" from within Homebrew Launcher. When you're done, you can press the Home or Minus buttons to exit. +### Wii and 3DS +There are work-in-progress ports to Wii and 3DS, with varying degrees of feature support. These platforms are not yet ready to be used by most users. -If you're using the [Aroma beta](https://github.com/wiiu-env/Aroma), you can use the .wuhb file instead of the .rpx to launch the app directly from the Wii U home menu instead of HBL. +**Note**: The Wii/3DS ports will utilize existing community repos (such as [Wii/OSC](https://oscwii.org) and [3ds/universal-db](https://db.universal-team.net/3ds/)). +## Configuration ### Custom Music -Place a mp3 file named `background.mp3` in one of the following two locations: +Place a mp3 file named `background.mp3` in one of the following locations: +- PC: `./background.mp3` (in the current directory) - Wii U: `sd:/wiiu/apps/appstore/background.mp3` - Switch: `sd:/switch/appstore/background.mp3` -### Web and Desktop -Web browsers can download files from the Homebrew App Store at [apps.fortheusers.org](https://apps.fortheusers.org). Source code: [hbas-frontend](https://github.com/fortheusers/hbas-frontend). - -Desktop platforms (Windows, MacOS, and Linux), can use @LyfeOnEdge's [unofficial-appstore](https://github.com/LyfeOnEdge/unofficial-appstore), or their alternative program: [HBUpdater](https://github.com/LyfeOnEdge/HBUpdater). - -There is a PC port of the same client source code for Linux, Mac, and Windows that can be downloaded from [the nightlies](https://nightly.link/fortheusers/hb-appstore/workflows/pc-builds/main). This will download files to an `sdroot` folder where the app is ran. - -### 3DS and Wii -There are work-in-progress ports to 3DS and Wii, with varying degrees of feature support. These can be compiled using the instructions below, but aren't yet ready to be used by most users. - -These clients are being developed with the intent to hook up to other existing non-libget repos (such as [Wii/OSC](https://oscwii.org) and [3ds/universal-db](https://db.universal-team.net/3ds/)) in the future. [libget has `*Repo.cpp` implementations](https://github.com/fortheusers/libget/tree/main/src) that would be extended to add this support. - -## Maintaining a repo -See [get's instructions](https://github.com/vgmoose/get#setting-up-repos) for setting up a repository. Everything is designed to be statically hosted. If there's no repo provided in the `repos.json` config file, then it will generate a default one pointing to [wiiu.cdn.fortheusers.com](https://wiiu.cdn.fortheusers.com) or [switch.cdn.fortheusers.com](https://switch.cdn.fortheusers.com). - -If you run into any issues and need help maintaining or setting up a libget repo, feel free to get in touch with vgmoose at me@vgmoose.com or on Discord. +### Submitting an App +See [hb-app.store/submit-or-request](https://hb-app.store/submit-or-request) for App Store guidelines and instructions on how to submit or request homebrew apps for to the main repositories. -## Compilation instructions -This program is written using [chesto](https://github.com/fortheusers/chesto) and has dependencies on libcurl, libget, and zlib. The chesto and libget libraries are included in this repo as submodules. SDL2 or SDL1 is also required depending on the target platform. +### Maintaining a repo +See [get's instructions](https://github.com/fortheusers/get#setting-up-repos) for setting up a repository. All repo JSON data and package zips are designed to be statically hosted as files, with no explicit backend logic. -You can get pre-compiled binaries for each platform under [GH Actions](https://github.com/fortheusers/hb-appstore/actions/workflows/main.yml) for a given commit. [Click here](https://nightly.link/fortheusers/hb-appstore/workflows/main/main) to download the latest nightly builds without signing in. +For more information on the API and self-hosting, see: [hb-app.store/api-info](https://hb-app.store/api-info) + +## Compiling +This program is written using [Chesto](https://github.com/fortheusers/chesto) and has dependencies on libcurl, libget, and zlib. The chesto and libget libraries are included in this repo as submodules. -### Building with Docker -The easiest way to build is using the [Sealeo](https://github.com/fortheusers/sealeo) docker container. It uses this [dependency helper script](https://github.com/fortheusers/sealeo/blob/main/dependency_helper.sh) to be able to build for all supported platforms. This is how the pre-compiled binaries are built. +[Pre-compiled nightlies](https://nightly.link/fortheusers/hb-appstore/workflows/main/main) to download the latest nightly builds without signing in. -1. Install [Docker](https://www.docker.com) -2. Run the following, replacing `switch` with the target platform (one of `switch`, `wiiu`, or `pc`): -``` -git clone --recursive https://github.com/fortheusers/hb-appstore.git -cd hb-appstore -export PLATFORM=switch # or wiiu, 3ds, wii, pc, pc-sdl1 -docker run -v $(pwd):/code -it ghcr.io/fortheusers/sealeo /bin/bash -c "cd /code && make $PLATFORM" -``` +### Instructions +Detailed build instructions for specific platforms can be found in [Compiling.md](https://github.com/fortheusers/hb-appstore/blob/main/docs/Compiling.md). -Depending on which platform you chose, `appstore.nro` or `appstore.rpx` should now be sitting in the cloned directory. When building for Wii U, an `appstore.wuhb` file will also be present. - -### Building for Specific Platforms -Compilation instructions for specific supported platforms (Switch, Wii U, 3DS, Wii) can be found in [Compiling.md](https://github.com/fortheusers/hb-appstore/blob/main/docs/Compiling.md) +In general, clone the repository recursively (with `git clone --recursive`) and run `make`, after installing the required platform dependencies. ## License This software is licensed under the GPLv3. -> Free software is software that gives you the user the freedom to share, study and modify it. We call this free software because the user is free. - [Free Software Foundation](https://www.fsf.org/about/what-is-free-software) - -### Maintainers -- [vgmoose](https://github.com/vgmoose) -- [pwsincd](https://github.com/pwsincd) -- [Nightkingale](https://github.com/Nightkingale) -- [rw-r-r_0644](https://github.com/rw-r-r-0644) -- [crc32](https://github.com/crc-32) -- [Compucat](https://github.com/compucat) - -## Contributing -If you have some functionality that you'd like to see feel free to discuss it on an [issues page](https://github.com/fortheusers/hb-appstore/issues), or if you already have an implementation or desire that you'd like to see, feel free to fork and make a [pull request](https://github.com/fortheusers/hb-appstore/pulls)! - -For code contributions, it's not required, but running a clang-format before making a PR helps to clean up styling issues: -``` -find . \( -name "*.cpp" -or -name "*.hpp" \) -not -path "./libs/*" -exec clang-format -i {} \; -``` - -### Contributors - -#### Code Contributors -This project exists thanks to all the people who contribute! - - -#### Financial Contributions -Special thanks to [dojafoja](https://github.com/dojafoja) for donating to the project in the past! The funds went directly torwards repository hosting and maintenance. ([Archived OpenCollective link](https://opencollective.com/fortheusers)) - -If you would like to monetarily support this project, we ask that you instead make a donation towards some other cause instead. Here are a few notable ones: - -- [Wikipedia / Wikimedia](https://donate.wikimedia.org/) -- [Electronic Frontier Foundation](https://www.eff.org) -- [Save the Children](https://www.savethechildren.org) -- [Partners in Health](https://www.pih.org) -- [Good Food Institute](https://gfi.org) -- [Mercy for Animals](https://mercyforanimals.org) -- [Fandom Forward](https://fandomforward.org) -- [NaNoWriMo](https://nanowrimo.org) +### Credits +For an up-to-date list of repo maintainers, app authors, and special thanks, see [hb-app.store/about](https://hb-app.store/about)! -Thank you! +### Contributing +If you have some functionality that you'd like to see feel free to discuss it on an [issues page](https://github.com/fortheusers/hb-appstore/issues), or if you already have an implementation or desire that you'd like to see, please send in a [pull request](https://github.com/fortheusers/hb-appstore/pulls)! diff --git a/docs/Compiling.md b/docs/Compiling.md index 44f20c1..15f8cb6 100644 --- a/docs/Compiling.md +++ b/docs/Compiling.md @@ -1,20 +1,42 @@ -Specific instructions for various platforms are covered here! +Specific instructions for building on various platforms are covered here! -## Building for Switch (with libnx) -1. Install [dkp-pacman](https://devkitpro.org/viewtopic.php?f=13&t=8702) -2. Install devkitA64 and needed Switch dependencies via dkp-pacman: +### Building with Docker (Recommended, All Platforms) +The easiest way to build is using the [Sealeo](https://github.com/fortheusers/sealeo) docker container. It uses this [dependency helper script](https://github.com/fortheusers/sealeo/blob/main/dependency_helper.sh) to be able to build for all supported platforms. This is how the pre-compiled binaries are built. + +1. Install [Docker](https://www.docker.com) +2. Run the following, replacing `switch` with the target platform (one of `switch`, `wiiu`, or `pc`): ``` -sudo dkp-pacman -S devkitA64 libnx switch-tools switch-curl switch-bzip2 switch-freetype switch-libjpeg-turbo switch-libwebp switch-sdl2 switch-sdl2_gfx switch-sdl2_image switch-sdl2_ttf switch-sdl2_mixer switch-zlib switch-libpng switch-mesa +git clone --recursive https://github.com/fortheusers/hb-appstore.git +cd hb-appstore +export PLATFORM=switch # or wiiu, 3ds, wii, pc, pc-sdl1 +docker run -v $(pwd):/code -it ghcr.io/fortheusers/sealeo /bin/bash -c "cd /code && make $PLATFORM" ``` -3. *If on macOS*: install gtar with: `brew install gnu-tar` (needed by resinfs) -4. Once it's all setup, recursively clone the repo and run make: + +Depending on which platform you chose, `appstore.nro` or `appstore.rpx` should now be sitting in the cloned directory. When building for Wii U, an `appstore.wuhb` file will also be present. + + +## Building for PC +Below instructions are for Ubuntu, but should be similar on other platforms. + +Both targets support the addition of `CFLAGS += -D_3DS_MOCK` in the Makefile to build a version that uses 3DS dimensions and layout logic for the window size. + +### Using SDL2 +The following produces `appstore.bin` in the current directory: ``` +sudo apt-get install libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libsdl2-gfx-dev zlib1g-dev gcc g++ libcurl4-openssl-dev git clone --recursive https://github.com/fortheusers/hb-appstore.git cd hb-appstore -make switch +make pc ``` -If all goes well, `appstore.nro` should be sitting in the current directory. +### Using SDL1 +The following produces `appstore.bin-sdl1` in the current directory: +``` +sudo apt-get install libsdl1.2-dev libsdl-ttf2.0-dev libsdl-image1.2-dev libsdl-gfx1.2-dev zlib1g-dev gcc g++ libcurl4-openssl-dev +git clone --recursive https://github.com/fortheusers/hb-appstore.git +cd hb-appstore +make pc-sdl1 +``` ## Building for Wii U (with WUT) 1. Install [dkp-pacman](https://devkitpro.org/viewtopic.php?f=13&t=8702) @@ -30,23 +52,24 @@ cd hb-appstore make wiiu ``` -If all goes well, `appstore.rpx` should be sitting in the current directory. +If all goes well, `appstore.rpx` and `appstore.wuhb` should be sitting in the current directory. -## Building for 3DS (with libctru) + +## Building for Switch (with libnx) 1. Install [dkp-pacman](https://devkitpro.org/viewtopic.php?f=13&t=8702) -2. Install devkitARM and needed 3DS dependencies via dkp-pacman: +2. Install devkitA64 and needed Switch dependencies via dkp-pacman: ``` -sudo dkp-pacman -S 3ds-sdl 3ds-sdl_image 3ds-sdl_mixer 3ds-sdl_gfx 3ds-sdl_ttf libctru citro3d 3dstools 3ds-curl 3ds-mbedtls +sudo dkp-pacman -S devkitA64 libnx switch-tools switch-curl switch-bzip2 switch-freetype switch-libjpeg-turbo switch-libwebp switch-sdl2 switch-sdl2_gfx switch-sdl2_image switch-sdl2_ttf switch-sdl2_mixer switch-zlib switch-libpng switch-mesa ``` 3. *If on macOS*: install gtar with: `brew install gnu-tar` (needed by resinfs) 4. Once it's all setup, recursively clone the repo and run make: ``` git clone --recursive https://github.com/fortheusers/hb-appstore.git cd hb-appstore -make 3ds +make switch ``` -If all goes well, `appstore.3dsx` should be sitting in the current directory. +If all goes well, `appstore.nro` should be sitting in the current directory. ## Building for Wii (with libogc) 1. Install [dkp-pacman](https://devkitpro.org/viewtopic.php?f=13&t=8702) @@ -64,25 +87,18 @@ make wii If all goes well, `appstore.dol` should be sitting in the current directory. -## Building for PC -There's a makefile for building the app on PC as well, primarily used for debugging and performance monitoring. Below instructions are for Ubuntu, but should be similar on other platforms. - -Both targets support the addition of `CFLAGS += -D_3DS_MOCK` in the Makefile to build a version that uses 3DS dimensions and layout logic for the window size. - -### Using SDL2 -The following produces `appstore.bin` in the current directory: +## Building for 3DS (with libctru) +1. Install [dkp-pacman](https://devkitpro.org/viewtopic.php?f=13&t=8702) +2. Install devkitARM and needed 3DS dependencies via dkp-pacman: ``` -sudo apt-get install libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libsdl2-gfx-dev zlib1g-dev gcc g++ libcurl4-openssl-dev -git clone --recursive https://github.com/fortheusers/hb-appstore.git -cd hb-appstore -make pc +sudo dkp-pacman -S 3ds-sdl 3ds-sdl_image 3ds-sdl_mixer 3ds-sdl_gfx 3ds-sdl_ttf libctru citro3d 3dstools 3ds-curl 3ds-mbedtls ``` - -### Using SDL1 -The following produces `appstore.bin-sdl1` in the current directory: +3. *If on macOS*: install gtar with: `brew install gnu-tar` (needed by resinfs) +4. Once it's all setup, recursively clone the repo and run make: ``` -sudo apt-get install libsdl1.2-dev libsdl-ttf2.0-dev libsdl-image1.2-dev libsdl-gfx1.2-dev zlib1g-dev gcc g++ libcurl4-openssl-dev git clone --recursive https://github.com/fortheusers/hb-appstore.git cd hb-appstore -make pc-sdl1 +make 3ds ``` + +If all goes well, `appstore.3dsx` should be sitting in the current directory. \ No newline at end of file