{"id":23060039,"url":"https://github.com/glaumar/qrookie","last_synced_at":"2025-04-07T10:20:18.059Z","repository":{"id":228582579,"uuid":"774384490","full_name":"glaumar/QRookie","owner":"glaumar","description":"Download and install Quest games from ROOKIE Public Mirror (like VRP Rookie Sideloader but for Linux and MacOS)","archived":false,"fork":false,"pushed_at":"2025-03-02T18:57:07.000Z","size":14038,"stargazers_count":103,"open_issues_count":16,"forks_count":9,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-06T11:44:55.327Z","etag":null,"topics":["aur","flatpak","kirigami2","linux","macos","meta-quest-2","meta-quest-3","nix","nixos","oculus-quest","qml","qt","qt6","quest","rookie","vr"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glaumar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-19T13:08:42.000Z","updated_at":"2025-04-03T04:10:20.000Z","dependencies_parsed_at":"2024-04-29T07:53:12.375Z","dependency_job_id":null,"html_url":"https://github.com/glaumar/QRookie","commit_stats":null,"previous_names":["glaumar/qrookie"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glaumar%2FQRookie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glaumar%2FQRookie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glaumar%2FQRookie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glaumar%2FQRookie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glaumar","download_url":"https://codeload.github.com/glaumar/QRookie/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247631833,"owners_count":20970069,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aur","flatpak","kirigami2","linux","macos","meta-quest-2","meta-quest-3","nix","nixos","oculus-quest","qml","qt","qt6","quest","rookie","vr"],"created_at":"2024-12-16T03:11:19.769Z","updated_at":"2025-04-07T10:20:18.031Z","avatar_url":"https://github.com/glaumar.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![](./icons/64x64/io.github.glaumar.QRookie.png) QRookie \nDownload and install Quest games from ROOKIE Public Mirror (like [VRP Rookie Sideloader](https://github.com/VRPirates/rookie) but for Linux and MacOS).\n\n# Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/Screenshot1.png\" width=\"640\"/\u003e\n\u003c/div\u003e\n\u003cdetails\u003e\n\u003csummary\u003eClick for more screenshots\u003c/summary\u003e\n    \u003cdiv align=\"center\"\u003e\n        \u003cimg src=\"screenshots/Screenshot2.png\" width=\"640\"/\u003e\n        \u003cimg src=\"screenshots/Screenshot3.png\" width=\"640\"/\u003e\n    \u003c/div\u003e\n\u003c/details\u003e\n\n---\n\n- [QRookie](#-qrookie)\n- [Screenshots](#screenshots)\n- [Download](#download)\n  - [Arch Linux](#arch-linux)\n    - [Install from AUR](#install-from-aur)\n  - [NixOS](#nixos)\n    - [Install directly](#install-directly)\n    - [Use with flake.nix (recommended)](#use-with-flakenix-recommended)\n  - [SteamOS And Other Linux](#steamos-and-other-linux)\n    - [Flathub](#flathub)\n    - [Flatpak Bundle](#flatpak-bundle)\n  - [MacOS](#macos)\n    - [MacOS Bundle](#macos-bundle)\n    - [Install using nix](#install-using-nix)\n    - [nix-darwin](#nix-darwin)\n- [FAQ](#faq)\n  - [1. Game installation failed?](#1-game-installation-failed)\n  - [2. Are all the games provided by QRookie? Are these games infected with viruses?](#2-are-all-the-games-provided-by-qrookie-are-these-games-infected-with-viruses)\n- [Develop](#develop)\n  - [Archlinux](#archlinux)\n    - [Install Dependencies](#install-dependencies)\n    - [Build](#build)\n  - [Flatpak](#flatpak)\n    - [Install Runtime](#install-runtime)\n    - [Build](#build-1)\n      - [Build Only](#build-only)\n      - [Build and Install](#build-and-install)\n      - [Export Flatpak Bundle](#export-flatpak-bundle)\n  - [NixOS](#nixos-1)\n    - [Enable Flakes](#enable-flakes)\n    - [Build](#build-2)\n    - [Run Without Cloning The Repository](#run-without-cloning-the-repository)\n  - [MacOS](#macos-1)\n    - [Install HomeBrew](#install-homebrew)\n    - [Build](#build-3)\n  - [MacOS (Nix)](#macos-nix)\n    - [Install Nix](#install-nix)\n    - [Build](#build-4)\n    - [Run Without Cloning The Repository](#run-without-cloning-the-repository-1)\n\n---\n\n# Download\n\n## Arch Linux \n\n![AUR Version](https://img.shields.io/aur/version/qrookie-vrp) ![AUR Last Modified](https://img.shields.io/aur/last-modified/qrookie-vrp)\n\n\n### Install from AUR\n```shell\nparu -S qrookie-vrp\n```\n\n## NixOS\n### Install directly\n```shell\nnix profile install github:glaumar/nur#qrookie\n```\n### Use with flake.nix (recommended)\nModify your flake.nix like：\n\n```nix\n# flake.nix\n{\n  inputs.glaumar_repo = {\n    url = \"github:glaumar/nur\";\n    inputs.nixpkgs.follows = \"nixpkgs\";\n  };\n\n  # ...\n\n  outputs = {nixpkgs, ...} @ inputs: {\n    nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {\n      modules = [\n        ({\n          nixpkgs.overlays = [\n            (final: prev: {\n              glaumar_repo = inputs.glaumar_repo.packages.\"${prev.system}\";\n            })\n          ];\n        })\n\n        # ...\n      ];\n    };\n  }\n}\n```\nThen you can use `pkgs.glaumar_repo.qrookie` in your other configuration modules.\n\n## SteamOS And Other Linux\nNow there is only a flatpak package, which can run on almost all linux distributions, including SteamOS (Steam Deck).\n\n### Flathub\n![Flathub Version](https://img.shields.io/flathub/v/io.github.glaumar.QRookie) ![Flathub Downloads](https://img.shields.io/flathub/downloads/io.github.glaumar.QRookie)\n\n\u003ca href='https://flathub.org/apps/io.github.glaumar.QRookie'\u003e\n    \u003cimg width='240' alt='Download on Flathub' src='https://flathub.org/api/badge?locale=en'/\u003e\n\u003c/a\u003e\n\n### Flatpak Bundle\n![GitHub Release](https://img.shields.io/github/v/release/glaumar/QRookie) ![GitHub Release Date](https://img.shields.io/github/release-date/Glaumar/QRookie) ![GitHub Downloads (specific asset, all releases)](https://img.shields.io/github/downloads/Glaumar/QRookie/QRookie.flatpak)  \n\n\nSee [releases](https://github.com/glaumar/QRookie/releases).\n\n## MacOS\n\n### MacOS Bundle\n![GitHub Downloads (specific asset, all releases)](https://img.shields.io/github/downloads/Glaumar/QRookie/QRookie_MacOs_arm64.dmg) ![GitHub Downloads (specific asset, all releases)](https://img.shields.io/github/downloads/Glaumar/QRookie/QRookie_MacOs_x86_64.dmg)  \n\nSee [releases](https://github.com/glaumar/QRookie/releases).\n\n\u003e [!WARNING]\n\u003e *The MacOS Bundle is automatically built using a github action and is not signed or notarized*\n\n\u003e [!WARNING]\n\u003e *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:*\n\u003e ```shell\n\u003e brew install java\n\u003e \n\u003e sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk\n\u003e ```\n\u003e\n\n### Install using nix  \n\n\u003e [!WARNING]\n\u003e *If you don’t know nix at all, we don’t recommend using this method to install QRookie.*\n\n\u003e [!WARNING]\n\u003e *More than 3GB of data may be downloaded during the first installation*\n\n1. **Install nix:** We recommend using the [graphical installer](https://determinate.systems/posts/graphical-nix-installer/) for installation. （From [here](https://nixcademy.com/2024/01/15/nix-on-macos/) you can find more ways to install nix on MacOS）\n\n2. **Install QRookie using flake:** \n```shell\nexport NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1\n\nnix profile install --impure github:glaumar/nur#qrookie \\\n--extra-experimental-features nix-command \\\n--extra-experimental-features flakes\n\nln -s ~/.nix-profile/Applications/QRookie.app /Applications\n```\n\n### nix-darwin\nRefer to [NixOS configuration](#use-with-flakenix-recommended)\n\n# FAQ\n\n## 1. Game installation failed?\nQRookie 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:\n- `~/.local/share/QRookie/` (ArchLinux、 NixOS)\n- `~/.var/app/io.github.glaumar.QRookie/data/QRookie/` （Flatpak）\n- `~/Library/Application Support/QRookie` (MacOS)  \n\nand manually install them ([Howto: Sideload Manually](https://vrpirates.wiki/en/Howto/Manual-Sideloading)).\n\n## 2. Are all the games provided by QRookie? Are these games infected with viruses?\n\nNo, 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** .\n\n# Develop\n## Archlinux\n### Install Dependencies\n```shell\nsudo pacman -S gcc cmake qt6-base qt6-declarative qcoro-qt6 kirigami extra-cmake-modules qqc2-breeze-style xdg-utils p7zip android-tools \n```\nSome packages need to be downloaded from AUR\n```shell\nparu -S android-sdk-build-tools android-apktool\n```\n\n### Build\n```shell\n# build\ncmake -B build -S . -DCMAKE_BUILD_TYPE='Release' -DCMAKE_INSTALL_PREFIX='/usr'\ncmake --build build --target QRookie\n\n# run\n./build/QRookie\n\n# install (not recommended)\ncmake --install build\n```\n\n## Flatpak\n### Install Runtime\n```shell\nflatpak install \\\n    runtime/org.kde.Platform/x86_64/6.6\\\n    runtime/org.kde.Sdk/x86_64/6.6\\\n    runtime/org.freedesktop.Sdk.Extension.openjdk21/x86_64/23.08\n```\n\n### Build\n#### Build Only\n```shell\nflatpak-builder build_flatpak  io.github.glaumar.QRookie.yml --force-clean\n```\n\n#### Build and Install\n```shell\nflatpak-builder build_flatpak  io.github.glaumar.QRookie.yml --force-clean --install --user\n```\n\n#### Export Flatpak Bundle\n```shell\nflatpak build-export export build_flatpak \u0026\u0026 flatpak build-bundle export QRookie.flatpak io.github.glaumar.QRookie --runtime-repo=https://flathub.org/repo/flathub.flatpakrepo\n```\n\n## NixOS\n### Enable Flakes \nAdd \n```nix\nnix.settings.experimental-features = [ \"nix-command\" \"flakes\" ];\n```\nto your `/etc/nixos/configuration.nix` , then run \n```\nsudo nixos-rebuild switch\n``` \nfor more details, please refer to [here](https://nixos-and-flakes.thiscute.world/nixos-with-flakes/nixos-with-flakes-enabled)\n\n### Build\n```shell\nnix build\n\n# run\n./result/bin/qrookie\n```\nor\n```shell\n# Create an shell that includes development tools and all dependencies\nnix develop\n\n# Then use CMake to build\ncmake -B build -S .\ncmake --build build --target qrookie\n\n# run\n./build/qrookie\n```\n\n### Run Without Cloning The Repository\n```shell\nnix run github:glaumar/QRookie\n```\n\n## MacOS\n### Install HomeBrew\n```shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n```\n\n### Build\n```shell\ncd ./macOs/\n\n# install dependencies, build and run\n./buildMacOs.sh  --open\n```\n\n## MacOS (Nix)\n### Install Nix\nWe recommend using the [graphical installer](https://determinate.systems/posts/graphical-nix-installer/) for installation.  \n\nFor more details, see [here](https://nixcademy.com/2024/01/15/nix-on-macos/)\n\n### Build\nSome dependencies in Nix are not supported on Darwin, but they can actually run if you force them to compile.  \n```shell\nexport NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1\n```\n```shell\nnix build --impure\n\n# run\n./result/bin/qrookie\n```\nor\n```shell\n# Create an shell that includes development tools and all dependencies\nnix develop --impure\n\n# Then use CMake to build\ncmake -B build -S .\ncmake --build build --target qrookie\n\n# run\n./build/qrookie\n```\n\n### Run Without Cloning The Repository\n```shell\nexport NIXPKGS_ALLOW_UNSUPPORTED_SYSTEM=1\n\nnix run --impure github:glaumar/QRookie\n```\n    \n    \n---\n![](https://badges.pufler.dev/visits/glaumar/QRookie)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglaumar%2Fqrookie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglaumar%2Fqrookie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglaumar%2Fqrookie/lists"}