DREAMSPACE> MANUAL

DREAMSPACE MANUAL

READING MESSAGES

Use an unbuffered console connection to watch the same room events. Reconnecting begins the sequence again:

curl -N "https://myortv.org/dreamspace/0000000000000000/events"

The stream sends room events with JSON data, presence events with the current stream count, and comment-only keepalives. It deliberately provides no event IDs or retry directive.

LISTENING TO RADIO

You can read radio outputs directly through mpv like this: 

 mpv "https://icecast.myortv.org/0000000000000000"
(nexuses only)

SUBMISSION

After dream-exploring session, every person is obliged to upload their data into myo_rtv psi network

To upload your data, you should visit:

CONNECT YOUR DEVICE RETURN TO DREAMSPACE INDEX

Input a 32-character device code from your psi console, insert max 1MB floppy disk into first (I) floppy disk drive.

Folowing your device manual, compress your data into pdl image. Then, upload your pdl file into myo_rtv psi network.

The device code is stored as the room's private creator_id. Your device code used to re-upload pdl image in case of network issues.

The radio_key is shareable and controls Nexus radio and chat commands.

An optional discoverer_note may be supplied.

ROOM FILE

You may verify pdl image content. Pdl images for dreamspace data follow next syntax:

#STARTHEADER
nexus: no
name: Name of your room
description: A persistent description of the room.
shader: pink_spiral
discoverer_note:

image: https://example.org/home-image

audio: https://example.org/home-audio
track: display name of your track

radio_key: key-used-for-sharing------------
public_push: no
tts_banwords: yes
#ENDHEADER


#STARTLIST messages
text: Message with all options
image: https://example.org/replace-current-image-with-this-image
audio: https://example.org/replace-current-music-with-this-music
track: replace track display name with this display
delay: 8
================================================================================
text: Minimal message
================================================================================
#ENDLIST messages

LIMITS

  • Complete PDL image: less than 1 MiB.
  • Room name: 50 characters max.
  • Description: 300 characters max.
  • Discoverer note: 150 characters max.
  • Text in one message: 2,000 characters max.
  • Event delays are specified in seconds. If omitted, the server chooses a random delay between 5 and 15 seconds.
  • An event may contain any combination of text, image, and audio.
  • Header audio and track fields define the room's initial soundtrack.
  • Message-list audio and track fields switch the soundtrack later.
  • An empty message-list audio: field stops playback. Omitting the field leaves the current soundtrack unchanged.

BACKGROUND SHADERS

Set one of these names in the room header's shader field:

  • pink_spiral - current shader
  • turbulent_tunnel
  • twisted_rays
  • glowing_marbling
  • morphing_abstract
  • chill_smoke_orb
  • one_line_one_world
  • field_slice
  • mechanical_tunnel — high GPU cost, bad on phones
  • dark_checkerboard — original dark tiled plane
  • protean_clouds -- with mouse input, but ported poorly
  • dth_str -- looks kinda bad, I will be fixing import here...

NEXUS

You may set nexus: yes into your room. This will disable messages and add live chat.

But this will not add radio access into your nexus. Shared hallusination experience naturally occure in long-standing nexus zones

CHAT

Live chat supports some commands:

!say for public espeak TTS (maximum 500 characters; no room key required)

!help to get help message

!image https://example.org/image.gif to temporarily change the Nexus image for everyone currently connected. The command remains in chat history, but the image override is not saved to the room PDL.

!push https://example.org/audio to queue one link for download

!pushplaylist https://example.org/playlist to download new playlist entries

Set public_push: yes to allow anyone to use the push and image commands. With public_push: no, the room's radio_key is required. This setting can also be changed with the Nexus radio control.

Set tts_banwords: no to disable the configured TTS banword check for this Nexus. Banwords are read from dreamtree/tts_banwords.txt, one word or phrase per line.

READING A STREAM

Use an unbuffered console connection to watch the same room events. Reconnecting begins the sequence again:

curl -N https://myortv.org/dreamspace/<room-id>/events

The stream sends room events with JSON data, presence events with the current stream count, and comment-only keepalives. It deliberately provides no event IDs or retry directive. The viewer requests autoplay for the header soundtrack and subsequent track events; when a browser blocks audible autoplay, the visitor must press play once.

LOST ROOM CODE

If you lost room url or code you used to create room, you can check your cookies, created rooms are saved there for this case.