storm/audiogame-manager
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix formatting inconsistancies, fix typos, add section for tag 2025.

Storm Dragon
2025-08-29 14:53:15 -04:00
parent d96f60ab7d
commit 4ea182b80f
5 changed files with 93 additions and 91 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
Arch-Linux.md

@@ -8,114 +8,104 @@ If your computer is x86_64, edit your /etc/pacman.conf file as root and uncommen
Before installing packages, make sure repositories are all updated with the command:
# pacman -Syy
```bash
pacman -Syy
```
## Packages
here is a list of packages required for both audiogame-manager and games installed by it to work optimally.
Here is a list of packages required for both audiogame-manager and games installed by it to work optimally:
- curl
- dialog
- cabextract
- gawk
- dos2unix
- unzip
- w3m
- wine
- winetricks
- wine_gecko
- wine-mono
- sdl2
- ncurses
- mpg123
- libpulse
- libpng
- libjpeg-turbo
- gnutls
- alsa-plugins
- alsa-lib
- mesa
- openal
- xz
- gst-plugins-bad
- gst-plugins-good
- gst-plugins-ugly
- gst-libav
- p7zip
- sox
- sqlite3
- translate-shell
- unrar
- xclip
```bash
pacman -S curl dialog cabextract gawk dos2unix unzip w3m wine winetricks wine_gecko wine-mono sdl2 ncurses mpg123 libpulse libpng libjpeg-turbo gnutls alsa-plugins alsa-lib mesa openal xz gst-plugins-bad gst-plugins-good gst-plugins-ugly gst-libav p7zip sox sqlite3 translate-shell unrar xclip
```
In addition, if you are on an x86_64 machine, you will need the following packages. but first, a note about lib32-ffmpeg and lib32-chromaprint.
In addition, if you are on an x86_64 machine, you will need the following lib32 packages:
```bash
pacman -S lib32-sdl2 lib32-ncurses lib32-mpg123 lib32-libpulse lib32-libpng lib32-libjpeg-turbo lib32-gnutls lib32-alsa-plugins lib32-alsa-lib lib32-mesa lib32-openal lib32-gst-plugins-good lib32-gst-plugins-bad lib32-gst-plugins-ugly lib32-gst-libav
```
**Note:** lib32-ffmpeg and lib32-chromaprint may require manual compilation (see below).
## lib32-ffmpeg and lib32-chromaprint
These packages both fail for some people. If that happens, some of the older games especially and some of the newer ones will not work or at the very least will not have sound. Since these are audio games, not having sound is pretty much synonymous with not working.
To fix this problem, compile the packages by hand, with makepkg. First use yay -G to grab the PKGBUILDs.
To fix this problem, compile the packages by hand with makepkg. First get the PKGBUILDs:
yay -G lib32-ffmpeg lib32-chromaprint
```bash
yay -G lib32-ffmpeg lib32-chromaprint
```
Next, build lib32-chromaprint:
### Building lib32-chromaprint:
cd lib32-chromaprint
```bash
cd lib32-chromaprint
```
Edit the PKGBUILD and change this line:
Edit the PKGBUILD and change:
```
-DBUILD_TESTS=ON
```
to:
```
-DBUILD_TESTS=OFF
```
-DBUILD_TESTS=ON
Delete the line starting with `-DGTEST_SOURCE_DIR` and remove the `check()` function (6 lines starting with `check() {`).
So that it reads:
Then run makepkg:
-DBUILD_TESTS=OFF
```bash
makepkg -si
```
Delete the next line, it starts with -DGTEST_SOURCE_DIR. Also, delete the check() function. It is 6 lines long and starts with:
### Building lib32-ffmpeg:
check() {
```bash
cd ../lib32-ffmpeg
```
After that, run makepkg:
makepkg -si
If it complains about missing packages, install them with yay and try makepkg again.
Next, change to the lib32-ffmpeg directory:
cd ../lib32-ffmpeg
edit the PKGBUILD for lib32-ffmpeg. Find the line that reads:
--enable-cuda-llvm
and change it to:
--disable-cuda-llvm
Edit the PKGBUILD and change:
```
--enable-cuda-llvm
```
to:
```
--disable-cuda-llvm
```
Run makepkg:
makepkg -si
```bash
makepkg -si
```
If it complains about missing packages, install them with yay and try makepkg again.
Note that you can delete the lib32-chromaprint and lib32-ffmpeg directories after the packages have installed. If you are doing updates and see these packages available, you may need to update them manually following the instructions above.
## lib32 package requirements
## Getting audiogame-manager
Clone the repository:
```bash
git clone https://git.stormux.org/storm/audiogame-manager
cd audiogame-manager
```
Make it executable:
```bash
chmod +x audiogame-manager.sh
```
Check dependencies:
```bash
./audiogame-manager.sh -c
```
- lib32-sdl2
- lib32-ncurses
- lib32-mpg123
- lib32-libpulse
- lib32-libpng
- lib32-libjpeg-turbo
- lib32-gnutls
- lib32-alsa-plugins
- lib32-alsa-lib
- lib32-mesa
- lib32-openal
- lib32-gst-plugins-good
- lib32-gst-plugins-bad
- lib32-gst-plugins-ugly
- lib32-gst-libav

16
Home.md

@@ -1,6 +1,18 @@
Here are instructions for setting up audiogame-manager on several distros. If you don't see your distro here, get in touch, and hopefully we can add instructions.
## 2025 Tag
Audiogame-manager has undergone nearly a complete rewrite in order to keep up with changes in wine. If you are happy with your current gaming setup and do not have latest wine, at the time of writing, 10.13, you can check out the 2025 tag:
``` bash
cd audiogame-manager
git checkout 2025
```
Note that the tag means no further development will be done. No games added, no bugs fixed. Basically this is done for those who have older, less up to date systems with working game installs who do not want to migrate to the new version.
## End of Mac Support
The Mac is no longer officially supported. Because of changes and breakage in some of the packages that audiogame-manager depends on, and because none of the developers who actively work on audiogame-manager use the Mac, it is impossible to provide the level of support needed to consider audiogame-manager stable on the Mac. that being said, Mac support is not being officially broken on our end. So if you can get it working that is great, but if not, I am unlikely to be able to help.
@@ -20,7 +32,7 @@ If you want to install something into a wine bottle created by audiogame-manager
Then, to run the installer or software, you would do something like the following:
WINEPREFIX=~/.local/wine/<bottle-name>/ wine "c:\<software name.exe"
WINEPREFIX=~/.local/wine/<bottle-name>/ wine "c:\<software name>.exe"
Want to donate to audiogame-manager? You can do so on the [Stormux Ko-fi page](https://ko-fi.com/stormux).
Want to donate to audiogame-manager? You can do so by becoming a [Stormux patron](https://patreon.com/stormux).

8
Mac.md

@@ -74,7 +74,7 @@ You can download the source of audiogame-manager by cloning the git repo
## Usage
In the terminal, switch to the folder in wich you have cloned the repo (Usually Downloads)
if you have cloned it into another folder cd to it
`cd ~/Downloads/audiogame-manager
`cd ~/Downloads/audiogame-manager`
Both the master and testing branches of the project will most likely contain code that is not compatible with the Mac. So to get the latest version that works most completely, checkout the last version that is most compatible with the Mac. Usage of the testing or master branches may cause problems with some games that may have worked previously.
@@ -82,7 +82,7 @@ Both the master and testing branches of the project will most likely contain cod
Now make it executable, you'll only have to do this once.
`chmod +x audiogame-manager.sh
`chmod +x audiogame-manager.sh`
### Help
View help by running:
@@ -94,14 +94,14 @@ Voiceover will not always read well in dialogs in the terminal. To get around th
### Installing a game
You can install a new game by running:
`./audiogame-manager.mac -i`
`./audiogame-manager.sh -i`
Select the game and press enter.
### Launching A Game
Run audiogame-manager without any flags to launch a game.
`./audiogame-manager.mac`
`./audiogame-manager.sh`
## 64 Bit Games

2
adding-games.md

@@ -11,7 +11,7 @@ First, find the list of games. This is easily done by searching for the comment:
# The list of games available for installation.
You will notice an array called gameList. Add the title, in quotes, to the array. Use the existing list as a guide to keep things formatted similarly. Games are approximately alphebatized, although I did add some of them prier to coffee, so that doesn't always hold true. So for our example, the entry here would be:
You will notice an array called gameList. Add the title, in quotes, to the array. Use the existing list as a guide to keep things formatted similarly. Games are approximately alphabetized, although I did add some of them prior to coffee, so that doesn't always hold true. So for our example, the entry here would be:
"My Awesome Game"

8
ipfs.md

@@ -9,10 +9,10 @@ This article will show you how you can sync our archive of audiogames on IPFS to
These instructions are going to require a bit of elbow grease in the command line, so be prepared to get into a console or a terminal emulator. In brief, you need to:
- install an IPFS daemon. For this wiki, I am assuming Kubo or go-ipfs, depending on how your package manager packages things.
- Initialize your demon.
- Initialize your daemon.
- Write a user service to start IPFS, or enable it on your system if such a service is available.
- Be sure that port 4001 is accessible, both by UDP and TCP.
- Start your demon.
- Start your daemon.
- Pin the directory resolved by way of IPNS.
@@ -54,14 +54,14 @@ ipfs daemon
### Sync the Archive
Now that yu have the IPFS node running, you can now get the archive and pin a copy locally by way of its IPNS key.
Now that you have the IPFS node running, you can now get the archive and pin a copy locally by way of its IPNS key.
```bash
ipfs pin add /ipns/k51qzi5uqu5dg7ndb48x1v9hzp98vg6wncrbhps16a8yn3eh4nqis7v384jh20
```
To ensure you have the latest archive, run the pin on a periodic interval. Additionally, if your node is slow in updating, as mine was, you can resolve the resolve the ipns entry by hand and pipe that into pin add.
To ensure you have the latest archive, run the pin on a periodic interval. Additionally, if your node is slow in updating, as mine was, you can resolve the ipns entry by hand and pipe that into pin add.
```bash
ipfs name resolve --nocache /ipns/k51qzi5uqu5dg7ndb48x1v9hzp98vg6wncrbhps16a8yn3eh4nqis7v384jh20 | ipfs pin add