日本語 - AstroDX ダウンロードガイド

Español - Guía para la Instalación de AstroDX

AstroDX Installation Guide

(iOS / iPadOS Edition)

Guide banner with text that says: AstroDX Installation Guide (iOS / iPadOS Edition)


Translator needed! 🤓

Those who want to copy this guide and translate it to your native language so that people who do not know English can still enjoy this game;
Please contact me @davidscann in the AstroDX Discord server, and I'll copy this template and hand it over to you (as well as clarifications if you need it). Thank you!

App installation
Step 1: Downloading TestFlight – Apple's Beta Testing programme
  • To enroll in testing AstroDX, you'll first need to download the TestFlight app from the App Store.
  • Once you've downloaded it, you can just leave it there. No need to open it yet.
Step 2: Finding the TestFlight Invitation
  • Assuming you've already joined the AstroDX Discord server, you should be able to find the TestFlight links in the TestFlight channel..
  • From here, scrolling up you should be able to find several links to various TestFlight groups.
  • If you're too lazy, here they are. However, I do still recommend you join the Discord server and look at the channels anyways because often times these groups get filled up very fast, leaving no slots. As for the reasons why this is the case, go here.
Step 3: Downloading and First Launch
  • Once you've entered an open TestFlight group, you should be able to just enroll and install the app.
  • After installing the game, you should open it up at least once in order to initialise the game.
    • This will make it easier for you to install your songs later.
Video guide
  • If you're having a hard time, follow this video guide in order to download the download the latest AstroDX version.
Song installation
Step 0: Where are the charts?
Step 1: Navigating to the directory
  • Using the Files app, navigate to the AstroDX/levels/ folder.

Did you download your charts on your computer instead?

For Mac OS users, I assume you can just AirDrop the files to your device. I don't have a Mac myself, so I can't show you how, but it should be possible.
For Windows and Linux users, I recommend heading to this section where I go into detail how to transfer files efficiently to i[Pad]OS.

Step 2: Putting songs into the right place
  • This is the folder structure that you are looking for.
    AstroDX
    │    cache
    │    settings.json
    └─── levels
        └─── category_folder (optional)
            └─── level_folder
                │    bg.jpg
                │    pv.mp4
                │    maidata.txt
                │    track.ogg
    
  • I know this is quite a bit to take in, but you can ignore every other directory other than the levels folder.
    • You put new levels inside of the levels/ directory, and optionally under a category folder (with any name.)
Step 3: Loading the songs into the game
  • Once you've inputted the songs according to the above format, you can go ahead and load the game up.
  • If you haven't restarted the game, you can tap the Refresh button in the library.
LocalSend – an open source alternative to AirDrop
  • This section is basically quintessential if you want to transfer files from your PC to your iPhone / iPad (unless it's a Mac, in which case just use AirDrop)
  • Download LocalSend on both your PC and your device.
  • Make sure that both devices are on the same WiFi network.
  • Keep the LocalSend app open on your mobile device. On your PC:
    • Open the Send menu.
    • Choose "Folder", and select the folder that includes your charts.
    • Your iPhone or iPad should be in this menu as well, with a codename. Click on the name.
    • Check your device. It should now have a prompt asking you if you want to Accept the files. Of course, Accept.
    • The files should now be in your Files app, under LocalSend.
    • Just move the transferred folder to AstroDX/levels/, and you're done! Just pop into the game and enjoy AstroDX.
Video guide
  • If you found the text confusing, here's a video guide that can help you.

FAQ (Fully Anticipated Questions)
  • I've put the .rar/.zip file into /levels, but it's still not working!
    • You'll need to extract the stuff inside first. Make sure that it matches the folder structure above.
  • Information regarding file compatibility
    • I couldn't phrase the question right, so I'm just gonna dump this info here.
    • The officially supported types of codecs for AstroDX on iOS:
      • Video: H.264
      • Audio: OGG Vorbis (with .ogg extension) OR mp3 (with .mp3 extension)
  • I swear I've put the mv.mp4 (or bg.mp4) file into the folder, but the background video isn't playing!
    • AstroDX only detects pv.mp4 for video files. mv.mp4 is what is needed to run the video in Majdata.
  • Why isn't the game on the App Store? Why go through the TestFlight troubles?
    • The reasons are twofold. We do not yet qualify for deployment on the App Store, and we want to be a fully fleshed game before we do so.
  • Why is the TestFlight so often full? When will I get my chance to play?
    • The short answer is, we don't know. The reason why there's a specific amount of slots is because that's all we can afford to open right now. It costs us to open these groups for you guys, and we're paying out of pocket.
  • If the slots run out that quickly, why don't you just open more groups? Why not a Group D and a Group E and so on?
    • Read above.
  • My god, I do not want to read any of that.
    • Cope, seethe, mald, and ping @davidscann in the AstroDX Discord server.

✨ made with love ❤️

Edit
Pub: 29 Feb 2024 06:27 UTC
Edit: 25 Jun 2024 15:52 UTC
Views: 13923