Select target directory for game files on first run

[narcisgarcia]

AppImage installs, updates and downloads studd to user's "Documents" directory.
Sometimes user has another disk volume with appropiate space, or even faster for games.
And sometimes "Documents" directory is a network drive, inconvenient for software or rapid i/o.

AppImage should ask where to install files on first run.

[p2004a]

Since last release, $XDG_STATE_HOME is used following XDG specification. Before then, it was Documents as you point out, and if launcher detects files there, it uses that location to not break existing installs.

So, it's following the standard behavior of Linux applications.

[narcisgarcia]

Thank you for attending this issue, but:
No answer for the request: Be able (user) to select target directory.

[p2004a]

1. You can set the directory be setting $XDG_STATE_HOME environment variable to what you want for application
2. You can also set the directory also by specifying --write-path argument to the application.

So there are already 2 separate options how you can set it.

EDIT: And of course you can also just use symlinks.

[narcisgarcia]

1. Download Beyond-All-Reason-1.2470.0.AppImage
2. Open file "properties" and enable executable checkbox
3. Double-click on AppImage file

How to say it something about XDG_STATE_HOME or write-path ?

Note symlinks don't work on network folders and some other filesystems.

[p2004a]

There are many options

• Use the menu editing program in your distribution (or something like https://flathub.org/apps/page.codeberg.libre_menu_editor.LibreMenuEditor if your distro doesn't ship one) to add entry with correct invocation

• Create a .desktop file with correct invocation following some instruction from internet, e.g. https://www.baeldung.com/linux/desktop-entry-files

• Run from command line

  ./Beyond-All-Reason-1.2470.0.AppImage --write-path /some/path
  # or
  XDG_STATE_HOME=/some/path ./Beyond-All-Reason-1.2470.0.AppImage

• Create wrapper script that does it for you, e.g. run_bar.sh

  #!/bin/sh
  ./Beyond-All-Reason-1.2470.0.AppImage --write-path /some/path
  

Note symlinks don't work on network folders and some other filesystems.

I strongly recommend not putting your home user directory on filesystem that doesn't support basic features like that, or overall putting it on networked filesystem. Putting BAR on networked file system is also pretty bad idea as it will very significantly slow down game load times (10k files to read)

[narcisgarcia]

It's not a rare practice to mount ~/Documents folder on a network resource.
But yes it's a rare practice to make an app installer to deploy its stuff at ~/Documents , which is intended for another use, fully controlled by user.

About launcher creation and registration with an additional shell script, I believed BAR app was targeted to unexperienced users.

[p2004a]

But yes it's a rare practice to make an app installer to deploy its stuff at ~/Documents , which is intended for another use, fully controlled by user.

As I noted already, this was resolved, and launcher is now following the freedesktop XDG specification and not installing files in Documents.

About launcher creation and registration with an additional shell script, I believed BAR app was targeted to unexperienced users.

I've listed multiple options. Changing the installation directory, unlike on Windows, is uncommon for Linux software, and I consider it an advanced configuration option. BAR is not targeting any specific category of users, but we try to make it streamlined for all users. Changing directory is possible and I consider advanced configuration that doesn't have to be easy.

---

If somebody external will be willing to write some nice smooth prompts and GUI for picking up directory on the first run, handle properly different cases and it wouldn't add a lot of complexity to launcher, I would accept such PR. So, I will reopen this, but it needs external contributor to resolve.