Xbox Cloud Gaming app for PS5 Homebrew
C
// SPDX-License-Identifier: GPL-3.0-or-later
// Copyright (C) 2026 RafaelNGP
// Game Pass catalog (catalog.gamepass.com), the source xbox.com/play uses for
// its rows: lists ("sigls") of product ids, and product details with names,
// descriptions, art and the xCloud title id needed to start a session.
// Public endpoints: no authentication.
#pragma once
#include <cstdint>
#include <map>
#include <string>
#include <vector>
namespace xc::json {
class Value;
}
namespace xc::xcloud {
struct Product {
std::string productId; // Store "big id"
std::string xcloudTitleId; // empty: not streamable
std::string xboxTitleId; // Xbox Live title id (titlehub), may be empty
std::string title;
std::string publisher;
std::string description;
std::string tileUrl; // square box art
std::string posterUrl; // 2:3
std::string heroUrl; // 16:9 background
std::vector<std::string> categories;
bool isPcOnly = false;
// From the full details only (`detailed`): how it can be played
// (kMode* bits) and, per language ("en", "pt"...: any of its locales),
// what is translated (kLang* bits).
bool detailed = false;
int64_t detailedAt = 0; // when the full details were fetched (unix s)
uint32_t modes = 0;
uint8_t plan = 0; // kPlanEssential..kPlanUltimate from PassMetadataByPassProductId
std::string ratingAge;
std::string ratingSystem;
std::vector<std::string> ratingDescriptors;
std::map<std::string, uint8_t> languages;
};
constexpr uint32_t kModeSingle = 1, kModeOnlineMulti = 2, kModeOnlineCoop = 4, kModeLocal = 8;
constexpr uint8_t kLangInterface = 1, kLangSubtitles = 2, kLangAudio = 4;
// The lowest Game Pass plan that includes a Game Pass game
// (PassMetadataByPassProductId in the full product details): Essential plays
// on Essential, Premium and Ultimate; Premium on Premium and Ultimate;
// Ultimate on Ultimate only. 0 = not known yet (or free-to-play / not Game Pass).
constexpr uint8_t kPlanNone = 0, kPlanEssential = 1, kPlanPremium = 2, kPlanUltimate = 3;
// The languages kept from a product's list: the app's own.
constexpr const char* kKeptLanguages[] = {"en", "pt", "es", "fr", "de", "it"};
// The lowest plan in a product's PassMetadataByPassProductId JSON object
// (Essential CFQ7TTC0K5DJ, Premium CFQ7TTC0P85B, else Ultimate).
uint8_t productPlanFromJson(const std::string& passMetadataJson);
// The tier 1..3 of an account's subscription ("Essential", "Premium",
// "Ultimate"); 0 when none or not one of the cloud plans ("PC", "").
uint8_t planTier(const std::string& subscription);
// Whether a plan of tier `plan` (1..3) includes a Game Pass game of
// `gamePlan` (0 unknown, 1..3); free-to-play games (`freeInStore`) are open
// to every plan and to no plan.
bool planIncludes(uint8_t plan, uint8_t gamePlan, bool freeInStore = false);
// Lists shown on xbox.com/play.
namespace sigl {
constexpr const char* kRecentlyAdded = "06323672-b8c8-43cc-b0de-32d5a9834749";
constexpr const char* kMostPopular = "6a589fa0-d493-472b-8e20-3813699d7056";
constexpr const char* kLeavingSoon = "31ff2361-2772-4622-849b-f4f1abb4ad1b";
constexpr const char* kAllGames = "af206485-e87d-4624-9007-cb7f6d0cc42e";
// "Stream free-to-play games": no Game Pass needed, but each must be on the
// account (a free "Get" in the store) before it starts.
constexpr const char* kFreeToPlay = "d8f4afcd-882a-49e3-86b3-f61fa0172b75";
} // namespace sigl
struct ProductList {
std::string title; // localized row title
std::vector<std::string> productIds;
};
// A genre as the app shows it: the store's long name for multiplayer online
// battle arenas, in any of the app's languages, becomes "MOBA" (the name
// players use); the others stay as the store has them.
std::string categoryName(const std::string& storeName);
// Returns true if titleId or titleName corresponds to a non-game add-on (artbook, soundtrack, install pack).
bool isNonGameAddon(const std::string& titleId, const std::string& titleName = "");
// Returns true if title or product represents a PC-only / non-cloud title.
bool isPcTitle(const std::string& title);
bool isPcProduct(const Product& p);
// Normalizes a title for universal cross-edition and cross-platform deduplication.
std::string normalizeBaseTitle(const std::string& title);
bool fetchList(const std::string& siglId, const std::string& market, const std::string& language, ProductList& out,
std::string& err);
// Details for `ids` (batched); products the catalog does not know are absent.
// `full` adds the hero art and description (about 5x the payload: ~10 KB
// per product instead of ~2 KB).
bool fetchProducts(const std::vector<std::string>& ids, const std::string& market, const std::string& language,
std::map<std::string, Product>& out, std::string& err, bool full = true);
// Parses official age classification and content descriptors from catalog JSON
// (preferring ClassInd for BR, ESRB for US, PEGI for EU).
void parseContentRatings(const json::Value& productJson, const std::string& market,
std::string& outAge, std::string& outSystem,
std::vector<std::string>& outDescriptors);
} // namespace xc::xcloud