Xbox Cloud Gaming app for PS5 Homebrew
C
// SPDX-License-Identifier: GPL-3.0-or-later
// Copyright (C) 2026 RafaelNGP
// Lightweight embedded HTTP server (port 8080) for remote configuration,
// live search typing, and log download via mobile browser / QR code.
#pragma once
#include "input/controller.h"
#include "platform/platform.h"
#include "util/json.h"
#include <atomic>
#include <cstdint>
#include <functional>
#include <memory>
#include <mutex>
#include <string>
namespace xc::app {
struct WebServerHooks {
std::function<void(json::Value& root)> getSettings;
std::function<bool(const json::Value& root)> updateSettings;
std::function<std::string()> getSearchQuery;
std::function<void(const std::string& query)> setSearchQuery;
std::function<void(const std::string* query, const std::string* tab, const json::Value* filters)> setSearchParams;
std::function<void(std::string& outQuery, std::string& outTab, json::Value& outFilters)> getSearchParams;
std::function<bool()> isStreaming;
std::function<void(int playerIndex, const input::ControllerState& state)> injectGamepad;
std::function<void(json::Value& stats)> getTelemetry;
std::function<void(json::Value& streamMenu)> getStreamMenuState;
std::function<bool(const json::Value& update)> updateStreamMenu;
std::function<void(const std::string& action)> streamAction;
};
void setWebServerHooks(WebServerHooks hooks);
// Virtual gamepad input query:
// playerIndex: 0..3 (Player 1..4)
// outState: contains current active buttons/axes (resets to neutral after ~2000ms of inactivity)
// isConnected: true if any report/keepalive received within ~4000ms
bool virtualGamepadState(int playerIndex, input::ControllerState& outState, bool& isConnected);
void setVirtualGamepad(int playerIndex, const input::ControllerState& state);
void touchVirtualGamepad(int playerIndex);
void switchVirtualGamepadSlot(int newSlot);
uint64_t virtualGamepadActiveAt(int playerIndex);
void resetVirtualGamepads();
const char* webServerIndexHtml();
namespace ws {
enum class Opcode : uint8_t {
Continuation = 0x0,
Text = 0x1,
Binary = 0x2,
Close = 0x8,
Ping = 0x9,
Pong = 0xA,
};
struct Frame {
bool fin = true;
Opcode opcode = Opcode::Text;
std::vector<uint8_t> payload;
};
std::string computeAccept(const std::string& key);
std::vector<uint8_t> makeFrame(Opcode opcode, const uint8_t* data, size_t len, bool fin = true);
std::vector<uint8_t> makeTextFrame(const std::string& text);
std::vector<uint8_t> makeBinaryFrame(const uint8_t* data, size_t len);
std::vector<uint8_t> makePongFrame(const std::vector<uint8_t>& pingPayload);
std::vector<uint8_t> makeCloseFrame(uint16_t code = 1000);
bool parseFrame(const uint8_t* data, size_t len, Frame& outFrame, size_t& bytesConsumed);
} // namespace ws
bool parseGamepadJson(const json::Value& val, int& outSlot, input::ControllerState& outState);
class WebServer {
public:
WebServer();
~WebServer();
bool start(uint16_t port = 8080);
void stop();
bool isRunning() const { return running_.load(); }
uint16_t port() const { return port_; }
std::string localIp() const;
std::string url() const;
// Direct request handler for testing without networking
struct HttpResponse {
int status = 200;
std::string contentType;
std::string extraHeaders;
std::string body;
};
HttpResponse handleRequest(const std::string& method, const std::string& path, const std::string& body);
private:
void threadLoop();
void handleClient(int clientFd);
void handleWebSocket(int wsFd);
std::atomic<bool> running_{false};
uint16_t port_ = 8080;
int listenFd_ = -1;
platform::Thread thread_{};
std::mutex wsMutex_;
std::vector<int> wsClients_;
};
extern std::unique_ptr<WebServer> g_webServer;
void startWebServer(uint16_t port = 8080);
void stopWebServer();
std::string webServerUrl();
} // namespace xc::app