Skip to content
fapnip edited this page Sep 20, 2021 · 108 revisions

About

OpenEOS (OEOS) is an open source implementation of the excellent Eos tease player from Milovana.com, with more features and greater flexibility than the original Eos player. (See some of the demos for examples of what OEOS can do.)

To create your own teases that can be played by OEOS, you'll need to use the Eos editor at milovana.com. (If you need an account at Milovana, you can request one.)

To play your Eos teases on OEOS you can use the public OEOS player:

https://oeos.art/?id=[your tease id]&key=[your tease key, if any]

Basically, just replace milovana.com/webteases/showtease.php in your Milovana tease URL with oeos.art to make it an OEOS URL. Your tease script will then be loaded from Milovana and played on the OEOS player.

(If unpublished, you'll find your private Milovana tease URL in Milovana's Eos editor under the "Share" link. If published, it's the URL in the address bar of your browser when playing the published tease.)

Notes:

  • The tease preview in Milovana's Eos editor will not work for OpenEOS teases.
  • The URL of the OEOS player will change if/when it gets a permanent home.
  • OpenEOS, and this Wiki, are currently under heavy development. Expect changes.
  • "Eos" is the property of Milovana.com. OpenEOS is not created or endorsed by Milovana.com.

Why would I want to use OEOS?

  1. More features than standard Eos, like linking to videos and animated gifs, dynamically generating actions from scripts, adding overlays to images, and more.

  2. Better tease debugging. OEOS outputs more accurate information about scripting issues in your evals and conditions to your browser's console, making it easier to figure out why your tease isn't working correctly. Additionally, if you append &preview=1 to your oeos.art tease URL, you'll see even more information about what OEOS is doing behind the scenes. (You can use &preview=2 if you want OEOS to vomit even more information on the console.)

Getting started

  1. Make sure you can access Milovana's Eos editor, then install the OpenEOS Editor Extensions to help make editing OpenEOS teases a little easier.

  2. Import one of the existing OEOS demos into your own tease in Milovana's Eos editor, and play around with it.

  3. Have a look at these examples:

  1. Look at the index of this Wiki, and find a subject that interests you.

  2. Check out the EOS tutorials for help getting started with standard Eos.

  3. Get help on Discord or Milovana.com

Contributing

If you'd like to see development of OEOS continue, please show your support by:

  • Testing existing teases on it and contributing bug reports and/or feature requests in the issues area.
  • Creating teases that use it and letting fapnip know about it at Milovana.com or on Discord.
  • Contributing code to the project via pull requests.
  • Contributing an icon for OpenEOS and/or loading indicator animation. (The feather currently used is borrowed from feathericons.com. License seems to allow it, but...)
  • Help pay for hosting.