Testing your scenes

This page gives some information on how to test your scene before distribution.

Estimating the performance

There is a RjDj scene called PerfTest?. It consists of oscillators, as many as RjDj can do. You can load this into Pd on the host to have a vague estimation of how far you can go with your patches.

Use Accelerometer data

Here are some accelerometer qlist files that can be used to have some accelerometer data on your desktop computer. The zip has a readme file and two patches to watch the data in action. http://rjdj.me/~geiger/accelerometerdata.zip

Check RjLib consistent use

You should make sure of at least the following before submitting a scene:

  • dac~ or adc~ are never used directly, instead soundoutput and soundinput are used respectively
  • all the abstractions required by _main.pd are at the root of the !Scene.rj folder
  • no other externals but the ones provided by RjLib are used throughout
  • the patch should not cause any error when run within Pd+RjLib

Putting patches on the iPhone

Rjz server

This also works for non-jailbroken devices including iPod Touch 2G. Chris McCormick's Rjz server is the easiest way to uploaded Scenes to your iThing. You need to have Python (at least 2.4) installed for it and the latest version of the RjDj Single with the scene download capability. Download Chris script from this repository.

Then do this:

  • Move rjzserver.py into the directory where your .rj directories live. (To work, a directory must have an .rj extension)
  • Make sure you have Python installed (rjzserver has been tested with Python 2.4)
  • Open up a console and chdir to the directory where you copied rjzserver.py
  • Find your IP address:
    • ifconfig on mac
    • ipconfig /a on windows (ipconfig /all on windows XP)
  • Run rjzserver.py like this:
    • "python rjzserver.py your-ip-address"
    • or "C:\Python24\python.exe rjzserver.py your-ip-address"
  • Test it by browsing to http://your-ip-address:8314/ on your PC (A successful test will list the .rj directories)
  • Configure your iThing (iPod iPhone)'s network settings: (For instance, go to Settings/Wifi/(Pick a network's blue arrow))
    • HTTP Proxy on
    • Manual
    • Server: your-ip-address
    • Port: 8314
  • Load up Safari and browse to "http://rjdj.me/" (this will not be the real rjdj.me anymore, but your rjzserver!)
  • Start rocking
  • When you've finished rocking, don't forget to switch off the proxy again to be able to browse the web the traditional way again.

If you have done a scene and want us to include it in the distribution, send it to scenes _AT_ rjdj dot me.

Other ways (deprecated)

If you have ssh installed on your machine, you can try the following command: 

 scp -pr MyScene.rj mobile@<phone_ip>:/var/mobile/Applications/*/RjDj.app/rjdj_scenes/

where you should replace <phone_ip> with the actual ip of your phone.

Note: If you have the RjDj Album version, the .app bundle is called RjDj_Album.app, and the command below should work: 

  scp -pr MyScene.rj mobile@<phone_ip>:/var/mobile/Applications/*/RjDj_Album.app/rjdj_scenes/

Deprecated: Putting patches on the iPod Touch (non-jailbroken) (should also work with non-jailbroken iPhone)

You should use rjzserver for that, but if you have problems, you may try this suggestion.

Note that following these instructions will delete everything under RjDj on your iPod. If you have any recordings you want to keep, you'll have to find some way of getting them off first.

  1. Locate RjDj.app on your computer. If you have access to the beta, this should be fairly straightforward. This needs to be outside of the iTunes magicalorganised path, somewhere iTunes doesn't know about in other words.
  2. Ctrl-click RjDj.app, 'show package contents'. Copy your homemade scenes into the rjdj_scenes folder here.
  3. Delete RjDj from your iPod, if it's already there (touch the app on the screen and hold your finger on it until all the icons start wriggling, then hit the little x; hit the home button to stop the icons wiggling).
  4. Delete RjDj from your iTunes Applications section: open iTunes, go to Applications on the left column (near the top), ctrl-click RjDj, 'delete'. If it asks, choose to move files to trash rather than keeping them.
  5. Sync your iPod and iTunes: click the name of your iPod on the left column in iTunes, click the 'sync' button on the bottom right.
  6. Drag your modified RjDj.app (the one you went 'show package contents' on) onto your iPod's icon on the left column in iTunes.
  7. Sync your iPod and iTunes. The progress bar at the top of iTunes should say 'syncing RjDj...' or something along those lines for a bit, while it copies over the application.