0. Get the MobMuPlat iOS or Android app
1. Create a user interface in the MobMuPlat Editor
2. Create an audio engine in PureData
3. Drag those two files into the MobMuPlat Documents folder in iTunes (iOS) or send them to your device storage (Android)
4. Play your app on your device!
Slightly more detailed:
MobMuPlat is a standalone iOS+Android app which hosts and loads from a list of available works. Creating your own work consists of two parts. First, creating a graphical user interface (GUI) with the MobMuPlat Editor (currently OSX only); second, creating the audio engine using the graphical programming language Pure Data (PD). With both of these applications open, and data sent between the two, you can simulate the app behavior on your laptop/desktop. Once development is complete, just drag the two saved files into the "Documents" folder of iTunes, and they are uploaded to your iOS device and can be opened in the MobMuPlat app. (For android, get the files onto your device storage folder anyway you like, then open them in the MobMuPlat app).
MobMuPlat can do synthesis, sampling, MIDI, OSC, networking via local wifi, query and set hardware characteristics like tilt/compass/camera flash, display images and vector graphics, be used within AudioBus (iOS only), take joystick/gamepad input (Android only) and much more.
1. Put the MobMuPlat app on your device. Get it from the iOS app store or from the Android Play Store (or download the APK directly.)
2. Download and unpack the zip file below. It contains the MobMuPlat Editor (both Cocoa and Java versions), a special distribution of Pd-vanilla, a pair of utility PD files, and a folder of tutorial files. PureData is available separately on all operating systems; the specially-packaged version is 0.45 with some externals included.
About the PD distribution: PD patches for your iOS/Android device must be made with "PD vanilla" (not Pd-extended), the basic distribution. However, in order to simulate the app on OSX (using OSC + UDP to communicate between PD and the MobMuPlat Editor), a few extra objects were needed, and so they've been included in this distribution, but they will not work if used in a patch for the mobile device. Pd-vanilla externals (expr, fiddle~, etc) _do_ work! THIS IS ABOUT TO CHANGE WITH PD .46! Soon you won't need my special PD distribution, stay tuned...
P.S. the editor creates ".mmp" files, which are actually just JSON-formatted text files. You can edit and create these manually if you are hard core.
3. Learn how to program in PD. That takes a bit of time. Some places to start: (1), (2), (3)
Learn the workflow by making your first piece - Hello, sine wave world!
1. Open MobMuPlatEditor
-Under the "Doc" tab, select your device under "Screen Size"
-Under the "Add" tab, click "slider", and drag/resize it on the canvas until it is nice and big
-Under the "Prop" tab, note the OSC-style address ("/mySlider"). Each GUI object should have a unique name. Leave it for now, though.
-The default range of a slider is 2, which means it sends continuous values 0-1. Change the range to 12, and it will send out integer values 0-11
-Hit the "Lock" tab, the editor is now in locked mode, so drag the slider and see the outgoing messages in the console
e)Save it, give it a distinctive name. it will create a ".mmp" file. (which is a JSON-style string, in case you care about that). Keep the editor and this file open.
2. Open Pd
-open the patch "MobMuPlatWrapper.pd". Don't change anything in this patch, this patch allows communication between the editor and your Pd patch.
-open the patch "MMPTutorial0.pd". Take a look at it. When you slide your slider in the editor, its value should show up in the patch. In the Pd window (apple-r) click "DSP" to turn on audio. You should hear a tone that responds to the slider. Feel free to tinker around in this patch before continuing.
-go back to the "doc" tab of the Editor, hit "Choose", and select the "MMPTutorial0.pd" patch.
3. Get patches onto your device:
iOS via iTunes: Connect your iOS device to your computer and open iTunes
-click the device in the left bar of iTunes, and then click "apps" along the top bar
-scroll down to the section "Apps with Documents", and then click MobMuPlat. If you've already used MobMuPlat on the device, then you'll see a list of files (.mmp files, .pd files, sound files, graphics files). Drag your saved .mmp file AND the "MMPTutorial0.pd" into this box, and they will be automatically copied onto the device.
iOS AND Android, via file association: .mmp, .pd, and .zip files are associated with MobMuPlat, so get these files onto your device by any means (email, file sharing e.g. Dropbox/Google Drive, download from web, Air Drop, etc). Then tap (or in some programs, long-press) the file, and open it in MobMuPlat. This will copy the files into the MobMuPlat folder (iOS: the app's Documents folder; Android: the MobMuPlat folder in the external storage folder aka SD card folder )
4. On your device, open MobMuPlat
-click the round info button on the welcome screen
-on the load screen, find your distinctively-named file, and click it
-you should see your slider. drag it up and you should hear your pitch. Congrats, you have made something!
Get more into it
Check out the series of tutorials (installed in the app, and also included in the software package), to see how various features work: GUI elements, networking, sampling, image files, hardware info, and more!
Documents and distribution
MobMuPlat finds whatever files it is looking for (.mmp, .pd, audio, images) in its documents folder. You drag all your files into this folder via iTunes on your computer (see workflow instructions above). You can also drag a .zip archive (containing all your work's files) into this folder, and it will show up in MobMuPlat's file list; click it there and it will unzip the files to the documents folder internally.
But wait, there's another way: you don't even need a computer/iTunes! MobMuPlat is associated with .mmp, .pd, audio, and .zip files. This means that if someone emails you an .mmp, .pd, audio, or .zip file, open it in your iOS Mail app, hold down the attachment link, and a popup will ask if you want to open the file in MobMuPlat. This will copy that file into MobMuPlat's document folder! (And if it is a zip it will unzip automatically). This also works for iOS versions of Safari links, Dropbox, etc.