nebula-project/NebulaBrowser
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Update linux sh files and appdir folder

Browse Source
This commit is contained in:
Andrew Zambazos
2026-01-21 11:26:26 +13:00
parent 1c24b914b3
commit c8c6397192
7 changed files with 294 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
appdir-example/Nebula
Executable
+185
View File
@@ -0,0 +1,185 @@
#!/usr/bin/env bash
# Run Nebula from an extracted AppImage folder with safe LD/XDG paths and Linux flags.
# This repo can end up with either:
# - nebula-appdir/squashfs-root/nebula (common after copying squashfs-root into nebula-appdir)
# - nebula-appdir/nebula (if you copied the extracted contents directly into nebula-appdir)
#
# PORTABLE MODE: User data (cookies, history, bookmarks) is stored in usr/data/ alongside the app.
# This keeps all data self-contained and portable on Linux.
set -euo pipefail
SELF_DIR="$(cd "$(dirname "$0")" >/dev/null 2>&1 && pwd)"
if [ -x "$SELF_DIR/nebula-appdir/nebula" ]; then
APPROOT="$SELF_DIR/nebula-appdir"
BIN="$APPROOT/nebula"
elif [ -x "$SELF_DIR/squashfs-root/nebula" ]; then
APPROOT="$SELF_DIR/squashfs-root"
BIN="$APPROOT/nebula"
elif [ -x "$SELF_DIR/nebula" ]; then
APPROOT="$SELF_DIR"
BIN="$APPROOT/nebula"
else
echo "Nebula binary not found. Expected either:"
echo "- $SELF_DIR/nebula-appdir/nebula"
echo "- $SELF_DIR/squashfs-root/nebula"
echo "- $SELF_DIR/nebula"
exit 1
fi
# --- PORTABLE DATA CONFIGURATION ---
# Store user data (cookies, history, bookmarks, etc.) in a local folder
# Data is stored with secure permissions (700 for dirs, 600 for files)
PORTABLE_DATA_DIR="$SELF_DIR/usr/data"
export NEBULA_PORTABLE=1
export NEBULA_PORTABLE_PATH="$PORTABLE_DATA_DIR"
# Create portable data directory with secure permissions if it doesn't exist
if [ ! -d "$PORTABLE_DATA_DIR" ]; then
mkdir -p "$PORTABLE_DATA_DIR"
chmod 700 "$PORTABLE_DATA_DIR"
fi
export LD_LIBRARY_PATH="$APPROOT/usr/lib:${LD_LIBRARY_PATH:-}"
export XDG_DATA_DIRS="$APPROOT/usr/share:${XDG_DATA_DIRS:-/usr/share}"
# =============================================================================
# STEAM INPUT CONFIGURATION - Always set these to prevent controller emulation
# =============================================================================
# These variables tell Steam's input layer that this app handles controller
# input natively and should NOT have mouse/keyboard emulation applied.
# Set unconditionally since Software apps may not receive Steam env vars.
# Disable Steam's virtual gamepad layer - CRITICAL for native controller support
export SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD=0
export STEAM_INPUT_ENABLE_VIRTUAL_GAMEPAD=0
# Allow raw gamepad access
export SDL_GAMECONTROLLER_IGNORE_DEVICES=""
# Allow background gamepad events (useful when app doesn't have focus)
export SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS=1
# Hint to SDL that we're using gamepads natively
export SDL_GAMECONTROLLERCONFIG="${SDL_GAMECONTROLLERCONFIG:-}"
# Steam can inject its overlay via LD_PRELOAD (gameoverlayrenderer.so).
# In some setups this breaks Chromium/Electron gamepad input. When we detect
# a Steam-launched session, strip the overlay preload but keep other entries.
# Also configure additional Steam-specific settings.
if [ -n "${SteamAppId:-}" ] || [ -n "${STEAM_APP_ID:-}" ] || [ -n "${STEAM_COMPAT_CLIENT_INSTALL_PATH:-}" ] || [ -n "${STEAM_COMPAT_DATA_PATH:-}" ]; then
# Enable Big Picture Mode for controller-friendly UI when launched from Steam
export NEBULA_BIG_PICTURE="${NEBULA_BIG_PICTURE:-1}"
# Enable GPU acceleration on Linux
export NEBULA_GPU_ALLOW_LINUX=1
if [ -n "${LD_PRELOAD:-}" ]; then
CLEANED_LD_PRELOAD=""
IFS=':' read -r -a _preload_parts <<< "$LD_PRELOAD"
for _p in "${_preload_parts[@]}"; do
[ -z "$_p" ] && continue
case "$_p" in
*gameoverlayrenderer.so*)
;;
*)
if [ -z "$CLEANED_LD_PRELOAD" ]; then
CLEANED_LD_PRELOAD="$_p"
else
CLEANED_LD_PRELOAD="$CLEANED_LD_PRELOAD:$_p"
fi
;;
esac
done
if [ -z "$CLEANED_LD_PRELOAD" ]; then
unset LD_PRELOAD
else
export LD_PRELOAD="$CLEANED_LD_PRELOAD"
fi
fi
fi
GPU_ARGS=()
# Optional GPU tuning profiles strike a balance between enabling hardware decode
# and keeping the launcher safe on systems with fragile Mesa/VA-API stacks.
# Default to enabling GPU tweaks on Linux unless explicitly disabled.
export NEBULA_GPU_PROFILE="${NEBULA_GPU_PROFILE:-}"
GPU_GL_MODE="${NEBULA_GPU_GL:-}"
export NEBULA_GPU_TWEAKS="${NEBULA_GPU_TWEAKS:-1}"
if [ "${NEBULA_GPU_TWEAKS}" = "1" ] && [ -z "$NEBULA_GPU_PROFILE" ]; then
export NEBULA_GPU_PROFILE=vaapi
fi
case "$NEBULA_GPU_PROFILE" in
vaapi)
GPU_ARGS+=(--ignore-gpu-blocklist)
GPU_ARGS+=(--enable-features=VaapiVideoDecoder,VaapiVideoEncoder,CanvasOopRasterization,UseSkiaRenderer,VaapiVideoDecoderLinuxGL,VaapiVideoDecoderLinuxZeroCopyGL)
GPU_ARGS+=(--enable-zero-copy)
GPU_ARGS+=(--enable-gpu-rasterization)
GPU_ARGS+=(--enable-accelerated-video-decode)
GPU_ARGS+=(--enable-native-gpu-memory-buffers)
if [ -z "${LIBVA_DRIVER_NAME:-}" ]; then
export LIBVA_DRIVER_NAME=radeonsi
fi
;;
angle)
GPU_ARGS+=(--ignore-gpu-blocklist)
GPU_ARGS+=(--enable-features=VaapiVideoDecoder,VaapiVideoEncoder,CanvasOopRasterization,UseSkiaRenderer,VaapiVideoDecoderLinuxGL)
GPU_ARGS+=(--enable-zero-copy)
GPU_ARGS+=(--enable-gpu-rasterization)
GPU_ARGS+=(--enable-native-gpu-memory-buffers)
GPU_ARGS+=(--enable-accelerated-video-decode)
if [ -z "${LIBVA_DRIVER_NAME:-}" ]; then
export LIBVA_DRIVER_NAME=radeonsi
fi
if [ -z "${AMD_VULKAN_ICD:-}" ]; then
export AMD_VULKAN_ICD=RADV
fi
;;
amd-handheld)
GPU_ARGS+=(--ignore-gpu-blocklist)
GPU_ARGS+=(--use-angle=vulkan)
AMD_HANDHELD_FEATURES="VaapiVideoDecoder,VaapiVideoEncoder,CanvasOopRasterization,UseSkiaRenderer,VaapiVideoDecoderLinuxGL,VaapiVideoDecoderLinuxZeroCopyGL"
if [ -n "${WAYLAND_DISPLAY:-}" ] || [ "${XDG_SESSION_TYPE:-}" = "wayland" ]; then
AMD_HANDHELD_FEATURES="UseOzonePlatform,WaylandWindowDecorations,${AMD_HANDHELD_FEATURES}"
GPU_ARGS+=(--ozone-platform-hint=auto)
GPU_ARGS+=(--ozone-platform=wayland)
fi
GPU_ARGS+=(--enable-features="$AMD_HANDHELD_FEATURES")
GPU_ARGS+=(--enable-zero-copy)
GPU_ARGS+=(--enable-gpu-rasterization)
if [ -z "${LIBVA_DRIVER_NAME:-}" ]; then
export LIBVA_DRIVER_NAME=radeonsi
fi
if [ -z "${MESA_VK_WSI_PRESENT_MODE:-}" ]; then
export MESA_VK_WSI_PRESENT_MODE=mailbox
fi
;;
software)
GPU_ARGS+=(--disable-gpu)
;;
"")
;;
*)
echo "Warning: Unknown NEBULA_GPU_PROFILE '$NEBULA_GPU_PROFILE'" >&2
;;
esac
if [ -n "$GPU_GL_MODE" ]; then
# Map common GL mode names to Electron-compatible values
case "$GPU_GL_MODE" in
egl|egl-angle) GPU_GL_MODE="angle" ;;
desktop) GPU_GL_MODE="desktop" ;;
esac
GPU_ARGS+=(--use-gl="$GPU_GL_MODE")
fi
if [ -n "${NEBULA_GPU_EXTRA_ARGS:-}" ]; then
# shellcheck disable=SC2086 # word splitting is intentional for custom flag tokens
read -r -a _nebula_gpu_extra <<< "${NEBULA_GPU_EXTRA_ARGS}"
GPU_ARGS+=("${_nebula_gpu_extra[@]}")
fi
exec "$BIN" --no-sandbox "${GPU_ARGS[@]}" "$@"
appdir-example/nebula.desktop
Executable
+10
View File
@@ -0,0 +1,10 @@
#!/usr/bin/env xdg-open
[Desktop Entry]
Name=Nebula
Comment=Nebula Browser (Portable Mode - data stored locally)
Exec=env NEBULA_GPU_TWEAKS=1 /home/deck/Documents/Repos/NebulaBrowser/nebula-appdir/Nebula %U
Terminal=false
Type=Application
Icon=nebula
Categories=Network;WebBrowser;
StartupWMClass=Nebula
appdir-example/run-nebula.sh
Executable
+24
View File
@@ -0,0 +1,24 @@
#!/bin/bash
# Run Nebula with portable data storage
# User data (cookies, history, bookmarks) is stored in usr/data/ alongside the app.
set -e
HERE="$(cd "$(dirname "$0")" && pwd)"
export APPDIR="$HERE"
export PATH="$HERE/usr/bin:$PATH"
export LD_LIBRARY_PATH="$HERE/usr/lib:$HERE/usr/lib64:$LD_LIBRARY_PATH"
# --- PORTABLE DATA CONFIGURATION ---
# Store user data in a local folder for portable operation
PORTABLE_DATA_DIR="$HERE/usr/data"
export NEBULA_PORTABLE=1
export NEBULA_PORTABLE_PATH="$PORTABLE_DATA_DIR"
# Create portable data directory with secure permissions if it doesn't exist
if [ ! -d "$PORTABLE_DATA_DIR" ]; then
mkdir -p "$PORTABLE_DATA_DIR"
chmod 700 "$PORTABLE_DATA_DIR"
fi
exec "$HERE/nebula-appdir/AppRun"
appdir-example/steam_appid.txt
+1
View File
@@ -0,0 +1 @@
4290110
appdir-example/usr/share/applications/nebula.desktop
+9
View File
@@ -0,0 +1,9 @@
[Desktop Entry]
Name=Nebula
Comment=Nebula Browser
Exec=./Nebula %U
Terminal=false
Type=Application
Icon=nebula
Categories=Network;WebBrowser;
StartupWMClass=Nebula
make-appdir.sh
Regular → Executable
+31 -1
View File
@@ -3,6 +3,7 @@
set -euo pipefail
SRC="${1:-squashfs-root}"
DEST="${2:-nebula-appdir}"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
if [ ! -d "$SRC" ]; then
echo "Source $SRC not found. Extract the AppImage first (./dist/Nebula-*.AppImage --appimage-extract)"
@@ -52,8 +53,37 @@ StartupWMClass=Nebula
EOF
fi
# Match appdir-example layout: extract app.asar to resources/app and keep app.asar.orig
if [ -f "$DEST/resources/app.asar" ]; then
if command -v npx &> /dev/null; then
echo "Extracting app.asar to resources/app (keeping app.asar.orig)"
(cd "$DEST/resources" && npx asar extract "app.asar" "app")
mv "$DEST/resources/app.asar" "$DEST/resources/app.asar.orig" 2>/dev/null || true
else
echo "Warning: npx not found; leaving app.asar in place."
fi
fi
# Copy Linux launch wrappers if present in appdir-example
if [ -f "$SCRIPT_DIR/appdir-example/run-nebula.sh" ]; then
cp "$SCRIPT_DIR/appdir-example/run-nebula.sh" "$DEST/run-nebula.sh"
chmod +x "$DEST/run-nebula.sh" || true
fi
if [ -f "$SCRIPT_DIR/appdir-example/steam_appid.txt" ]; then
cp "$SCRIPT_DIR/appdir-example/steam_appid.txt" "$DEST/steam_appid.txt"
fi
if [ -f "$SCRIPT_DIR/appdir-example/nebula.desktop" ]; then
cp "$SCRIPT_DIR/appdir-example/nebula.desktop" "$DEST/nebula.desktop"
cp "$SCRIPT_DIR/appdir-example/nebula.desktop" "$DEST/usr/share/applications/nebula.desktop"
fi
# Ensure root launcher exists (from example if needed)
if [ -f "$SCRIPT_DIR/appdir-example/Nebula" ]; then
cp "$SCRIPT_DIR/appdir-example/Nebula" "$DEST/Nebula"
chmod +x "$DEST/Nebula" || true
fi
# Fix permissions
chmod -R a+r "$DEST/usr/share/icons/hicolor/256x256/apps" || true
chmod +x "$DEST/Nebula" || true
echo "AppDir assembled at $DEST. Run with: $DEST/Nebula"
echo "AppDir assembled at $DEST. Run with: $DEST/run-nebula.sh"
update-appdir.sh
+32 -2
View File
@@ -5,24 +5,54 @@
set -e
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
APP_DIR="$SCRIPT_DIR/nebula-appdir/nebula-appdir/resources/app"
APPDIR_ROOT="$SCRIPT_DIR/nebula-appdir"
# Support both layouts:
# 1) nebula-appdir/resources/app
# 2) nebula-appdir/nebula-appdir/resources/app (example layout)
if [ -d "$APPDIR_ROOT/resources" ] || [ -f "$APPDIR_ROOT/resources/app.asar" ]; then
RESOURCES_DIR="$APPDIR_ROOT/resources"
else
RESOURCES_DIR="$APPDIR_ROOT/nebula-appdir/resources"
fi
APP_DIR="$RESOURCES_DIR/app"
ASAR_FILE="$RESOURCES_DIR/app.asar"
ASAR_ORIG_FILE="$RESOURCES_DIR/app.asar.orig"
echo "🚀 Updating Nebula AppDir..."
echo " Source: $SCRIPT_DIR"
echo " Target: $APP_DIR"
echo ""
# Check if target exists
# Check if target exists (or extract from app.asar if present)
if [ ! -d "$APP_DIR" ]; then
if [ -f "$ASAR_FILE" ] || [ -f "$ASAR_ORIG_FILE" ]; then
if command -v npx &> /dev/null; then
if [ -f "$ASAR_FILE" ]; then
echo "ℹ️ app.asar detected. Extracting to $APP_DIR..."
(cd "$RESOURCES_DIR" && npx asar extract "app.asar" "app")
mv "$ASAR_FILE" "$ASAR_ORIG_FILE" 2>/dev/null || true
else
echo "ℹ️ app.asar.orig detected. Extracting to $APP_DIR..."
(cd "$RESOURCES_DIR" && npx asar extract "app.asar.orig" "app")
fi
else
echo "❌ Error: $APP_DIR not found and npx is not available to extract app.asar."
echo " Install Node.js/npm, then run:"
echo " cd $RESOURCES_DIR && npx asar extract app.asar app"
exit 1
fi
else
echo "❌ Error: AppDir not found at $APP_DIR"
exit 1
fi
fi
# Files to sync (main app files)
FILES=(
"main.js"
"preload.js"
"package.json"
"portable-data.js"
"gpu-config.js"
"gpu-fallback.js"
"performance-monitor.js"