LOADER FOR MAC OSX/LINUX

Automatic online install:

1. Open terminal

2. Run command:

/bin/bash -c "$(curl -fsSL https://github.com/skrimix/QLoaderFiles/raw/master/onlineinstall.sh)"

3. Open Loader

(macOS) Run by double-clicking Loader

(Linux) Run from terminal

Video tutorial by Ginfio: (removed by YouTube)

Manual install:

Linux instructions:

0. Install VLC player if you're going to be adding gameplay trailers. You may also need to install libx11-dev and libvlc-dev packages

1. Download and unpack the archive

2. Run Loader in terminal

Mac instructions:

1. Download and unpack the archive

2. In Terminal run these commands (replace <path_to_unpacked_osx-x64> with your actual path):

cd <path_to_unpacked_osx-x64>
xattr -rd com.apple.quarantine .

3. Run Loader with double click

To install gameplay trailers:

Download TrailersAddon.zip and move it into Loader's folder. Loader will automatically unpack it on next launch

Uninstall:

Delete Loader's folder

Notes:

• Beta version, report bugs and crashes to @skrimix in @FFAHelp chat
• You can click on a running task to cancel download or dismiss finished task
• You can drag and drop APK files, downloaded game files and backups
• Double-click on a game to open details. Details can include game thumbnail, trailer, store rating and description (whatever is available)

Supported platforms:

• macOS High Sierra 10.13 and higher
• Linux (X11 or Xwayland, x64 or arm64, Debian 9 (Stretch) and higher, Ubuntu 16.04 and higher, Fedora 30 and higher, Arch Linux, and maybe others)
• Windows 8 and higher (Note: Loader works correctly on Windows 7 also, but not supported officially)

Troubleshooting:

Linux

• If you get a crash with message Unhandled exception. System.InvalidOperationException: Default font family name can't be null or empty. you need to install Microsoft fonts. On Arch distros the simplest way is to install ttf-ms-fonts from AUR and run fc-cache --force. To find instructions for other distros use your preferred search engine.
• If you get Failed to initialize video player notification when opening game details you need to install VLC player, libx11-dev and libvlc-dev packages (on Arch it's libx11 from extra repository, and libvlc from AUR).

Mac

• Crash with message Unhandled exception. System.DllNotFoundException: Unable to load shared library 'libAvaloniaNative' or one of its dependencies. The cause of this issue is unknown, rebooting your Mac and/or reinstalling Loader should help.
• Crash with message dyld: lazy symbol binding failed: Symbol not found: _syslog$DARWIN_EXTSN. Most likely your macOS version is too old, Loader supports only versions High Sierra 10.13 and higher.

Changelogs:

v0.2.5-beta

This update is mandatory, online functionality does not work on older versions

Added:

• Vip mirrors support

Fixed:

• Crash on manual reloading of mirror list when no mirrors available
• Missing Russian translation for some notifications

Other changes:

• Updated rclone files
• Removed 10sec auto dismiss for "No mirrors available" notification
• Game donation now can be cancelled on pulling files from device

v0.2.4-beta

Added:

• Windows support
• Trailers addon download progress display
• Cancellable sideloading process
• Cancellable backup creation process
• Auto donation
• Russian localization (98% translated). You can force English display language in settings if you want

Fixed:

• Video player not working in new installations on macOS since v0.2.2
• Error when trying to install Beat Saber with BMBF if Beat Saber Demo is installed
• Game list loading error on systems with Arabic calendars
• Error when installing Beat Saber with new install.txt script

Other changes:

• Now using system proxy settings
• More accurate download size calculation, therefore progress is more accurate too
• Rewritten all text to support localization, please report if you find any typos or other mistakes

v0.2.3-beta

This hotfix release addresses several issues introduced in v0.2.2

Fixed:

• Wrong url in game download reporting
• Apk info reading errors potentially caused by ApkNet bug (reverted to using aapt2)
• Drag and dropping apk file from downloads folder when "Delete after install" is enabled causing task to get stuck on "Deleting downloaded files"

v0.2.2-beta

Loader is now in beta

Added:

• Confirmation flyout before uninstallation
• Button for running "adb devices" command in connection help dialog
• Remote logging (opt-in in settings)
• Mirror list reload button
• Create backup button and Restore Backups page

Fixed:

• "On Device" column refresh failing under certain circumstances and causing "Error while checking device connection" message
• Rare crash on empty device list
• Potential selections conflict between "Donate Games" and "Other Apps" pages
• Crash in case of updater initialization error
• Error when resetting device texture resolution to Auto
• Potential issues with game details dialog and trailer player
• Improper deactivation of loading animation causing constant cpu and gpu load
• Crash when trying to create updater config file on some macOS systems
• Error extracting info from apk file if path contains space character
• Error when trying to auto reinstall drag dropped apk files
• OBB directories not being fully overwritten on update causing old OBB files to fill up storage
• Dylib loading error after self update (fixed in updater, so will only come in effect when updating from this version)
• Automatic relaunch after self update (same as above, only for subsequent updates)

Other changes:

• UI design improvements
• Replaced "Delete after install" setting with "Downloads pruning policy", with "Delete after install" option set as the default option
• Improved "No games to update" notification logic
• Enabled manual columns resizing
• Now when enabling Wireless ADB, device switcher and "Enable Wireless ADB" button will be blocked for 5 seconds
• Improved devices connections switching logic
• Moved updater config file into Loader's folder. If you are updating from older version, you can delete leftover "Loader" folder from ~/.config/
• Unavailable mirrors are excluded from mirror list on launch. You can reload mirror list in settings
• Apk reading is now handled in c# code, removed aapt2 binary (experimental)
• Now if you delete thumbnails from Resources folder Loader won't try to redownload it (self update will, though)
• Background trailers addon installation now shown in UI as a task

v0.2.1-alpha

Added:

• Linux arm64 support (self-updater not tested)
• Installing trailers addon from settings page
• Clear button in search bar
• Folder picker for downloads and backups locations
• In-app notifications (error notifications show error details on click when available)
• Game descriptions and ratings from Oculus and AppLab stores in game details window
• "Other Apps" page
• "Show hidden" checkbox in game donation page
• Force uninstalling admin apps
• "ADB unauthorized" info bar
• 2 help dialogs for connection issues (no device and adb unauthorized)

Fixed:

• Device connection check failing in some cases
• Available games list population called at the wrong time causing warnings
• Debug logs not being written to disk above 3MB file size

Other changes:

• Renamed "Version Name" column to "Installed Version" and changed version format to "versionName (versionCode)"
• In "Donate Games" page "Ignore Selected" button can now be used to remove apps from ignore list

v0.2.0-alpha

Added:

• "No Device Connection" status indicator
• "Download only" function
• "Update All" function (will skip games that have multiple releases available, to avoid unwanted installation of different versions)
• self updater (experimental)
• game donations
• "Delete after install" setting
• popularity column
• version name column
• Drag&Drop support (doesn't work on Linux due to upstream issue)
• hint on hovering mouse pointer over task
• more tooltips
• "On Device" column in available games list to mark installed games
• mirror switch
• automatic reinstall on incompatible updates (signature mismatch, downgrade, etc.)
• automatic rclone config and resources update
• scrolling in settings page
• version label in settings
• device serial in device switch toolip

Fixed:

• empty installed games list for some devices
• selections being ignored when filtered out by search
• quest 1 icon not showing
• some trailers not being found on case-sensitive filesystems

Other changes:

• Loader will try to cancel all running tasks automatically on exit (only queued operations and running downloads are cancellable currently. Don't close Loader when it's installing something)
• sideloading is disabled automatically when there is no device connection
• reduced lag on some actions that require device connection check
• new loading overlay
• improved download error handling
• improved device id scrambling
• improved backups
• other performance and stability improvements

v0.1.2-alpha

• new online installer, check instructions post
• fixed Quest 1 identification
• fixed crash when uninstalling multiple games
• fixed conflict with sidenoder and other rclone instances
• maybe fixed some random download failures. Please report if you still have downloads failing
• if game list is broken Loader will try to switch to another mirror instead of giving up
• exceptions log file is now retained between launches
• autosave settings after restoring defaults
• added downloader bandwidth limit setting
• if trailers add-on zip is found nearby, it will be installed automatically

v0.1.1-alpha

• temporary fix to avoid possible data loss when updating small subset of games

v0.1.0-alpha

• initial alpha release