Skip to content

Latest commit

 

History

History
322 lines (256 loc) · 9.19 KB

README.md

File metadata and controls

322 lines (256 loc) · 9.19 KB
Raw

QRookie

Download and install Quest games from ROOKIE Public Mirror (like VRP Rookie Sideloader but for Linux and MacOS).

Screenshots

Click for more screenshots

Download

Arch Linux

AUR Version AUR Last Modified

Install from AUR

paru -S qrookie-vrp

NixOS

Install directly

nix profile install github:glaumar/nur#qrookie

Use with flake.nix (recommended)

Modify your flake.nix like：

# flake.nix
{
  inputs.glaumar_repo = {
    url = "github:glaumar/nur";
    inputs.nixpkgs.follows = "nixpkgs";
  };

  # ...

  outputs = {nixpkgs, ...} @ inputs: {
    nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
      modules = [
        ({
          nixpkgs.overlays = [
            (final: prev: {
              glaumar_repo = inputs.glaumar_repo.packages."${prev.system}";
            })
          ];
        })

        # ...
      ];
    };
  }
}

Then you can use pkgs.glaumar_repo.qrookie in your other configuration modules.

SteamOS And Other Linux

Now there is only a flatpak package, which can run on almost all linux distributions, including SteamOS (Steam Deck).

Flathub

Flathub Version Flathub Downloads

Download on Flathub

Flatpak Bundle

GitHub Release GitHub Release Date GitHub Downloads (specific asset, all releases)

See releases.

MacOS

MacOS Bundle

GitHub Downloads (specific asset, all releases) GitHub Downloads (specific asset, all releases)

See releases.

Warning

The MacOS Bundle is automatically built using a github action and is not signed or notarized

Warning

The MacOS Bundle does not include java runtime. If you want to use the rename pkg function, you need to install the java runtime additionally:

brew install java

sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

Install using nix

Warning

If you don’t know nix at all, we don’t recommend using this method to install QRookie.

Warning

More than 3GB of data may be downloaded during the first installation

  1. Install nix: We recommend using the graphical installer for installation. （From here you can find more ways to install nix on MacOS）

  2. Install QRookie using flake:

export NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1

nix profile install --impure github:glaumar/nur#qrookie \
--extra-experimental-features nix-command \
--extra-experimental-features flakes

ln -s ~/.nix-profile/Applications/QRookie.app /Applications

nix-darwin

Refer to NixOS configuration

FAQ

1. Game installation failed?

QRookie currently does not support install.txt. Some games may fail to install or may not run after installation. You can find the downloaded games in:

  • ~/.local/share/QRookie/ (ArchLinux、 NixOS)
  • ~/.var/app/io.github.glaumar.QRookie/data/QRookie/ （Flatpak）
  • ~/Library/Application Support/QRookie (MacOS)

and manually install them (Howto: Sideload Manually).

2. Are all the games provided by QRookie? Are these games infected with viruses?

No, QRookie does not provide any games. It is just a downloader that downloads games from public servers. QRookie does not know what it is downloading, and it does not check whether the downloaded content is a legitimate game or a virus. To ensure the safety of your VR device, please do not use QRookie .

Develop

Archlinux

Install Dependencies

sudo pacman -S gcc cmake qt6-base qt6-declarative qcoro-qt6 kirigami extra-cmake-modules qqc2-breeze-style xdg-utils p7zip android-tools

Some packages need to be downloaded from AUR

paru -S android-sdk-build-tools android-apktool

Build

# build
cmake -B build -S . -DCMAKE_BUILD_TYPE='Release' -DCMAKE_INSTALL_PREFIX='/usr'
cmake --build build --target QRookie

# run
./build/QRookie

# install (not recommended)
cmake --install build

Flatpak

Install Runtime

flatpak install \
    runtime/org.kde.Platform/x86_64/6.6\
    runtime/org.kde.Sdk/x86_64/6.6\
    runtime/org.freedesktop.Sdk.Extension.openjdk21/x86_64/23.08

Build

Build Only

flatpak-builder build_flatpak  io.github.glaumar.QRookie.yml --force-clean

Build and Install

flatpak-builder build_flatpak  io.github.glaumar.QRookie.yml --force-clean --install --user

Export Flatpak Bundle

flatpak build-export export build_flatpak && flatpak build-bundle export QRookie.flatpak io.github.glaumar.QRookie --runtime-repo=https://flathub.org/repo/flathub.flatpakrepo

NixOS

Enable Flakes

Add

nix.settings.experimental-features = [ "nix-command" "flakes" ];

to your /etc/nixos/configuration.nix , then run

sudo nixos-rebuild switch

for more details, please refer to here

Build

nix build

# run
./result/bin/qrookie

or

# Create an shell that includes development tools and all dependencies
nix develop

# Then use CMake to build
cmake -B build -S .
cmake --build build --target qrookie

# run
./build/qrookie

Run Without Cloning The Repository

nix run github:glaumar/QRookie

MacOS

Install HomeBrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Build

cd ./macOs/

# install dependencies, build and run
./buildMacOs.sh  --open

MacOS (Nix)

Install Nix

We recommend using the graphical installer for installation.

For more details, see here

Build

Some dependencies in Nix are not supported on Darwin, but they can actually run if you force them to compile.

export NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1
nix build --impure

# run
./result/bin/qrookie

or

# Create an shell that includes development tools and all dependencies
nix develop --impure

# Then use CMake to build
cmake -B build -S .
cmake --build build --target qrookie

# run
./build/qrookie

Run Without Cloning The Repository

export NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1

nix run --impure github:glaumar/QRookie