Skip to content
This repository has been archived by the owner on Feb 12, 2023. It is now read-only.

Commit

Permalink
doc: Update CHANGELOG and README
Browse files Browse the repository at this point in the history
  • Loading branch information
qdot committed May 15, 2021
1 parent 3ddbf4f commit 8675546
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 47 deletions.
20 changes: 20 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# v3

## Features

- Update to Buttplug C# v2
- Add vibration handling

# v2

## Features

- Rename from VAMLaunch to VaMSync, since the Launch is dead.
- Update VaMSync to buttplug C# v1
- Allow VaMSync to connect to Intiface Desktop

# v1 (2019-07-04)

## Features

- Initial release fo VAMLaunch w/ Buttplug C# 0.5
62 changes: 15 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,49 @@
# VAM Launch v2.0
# VAM Sync

## VAM Plugin that adds support for stroking/vibrating devices thru Buttplug.io
**VAM Plugin that adds support for stroking/vibrating devices thru Buttplug.io**

Download Latest: [v2.0](https://github.com/intiface/VaMSync/releases/)
Download Latest: [v3](https://github.com/intiface/VaMSync/releases/)

### Version 2.0 Features
## IMPORTANT SUPPORT NOTE

- Change name to VaMSync (as the launch is no longer a product)
- Update to Buttplug v1.x, including support for the [Kiiroo Keon](https://kiiroo.keon.buttplug.io) and [The Handy](https://thehandy.buttplug.io).
- Add capabilities to connect VaMSync to Intiface Desktop, meaning that even if this program isn't updated, it should still be able to connect to new toys.
The current maintainer of VaMSync is also the maintainer of [Buttplug.io](https://buttplug.io), and does not use VaM. While filing of issues is appeciated, few if any bugs on the VaM side will be able to be addressed by the buttplug.io team.

### Version 1.0 Features
If you are interested in helping with VaM-side issues, please comment either in the issues or the discussions area!

A HUGE thanks to [qdot](https://github.com/qdot) for collaborating with me to bring you:
#### • <a href="https://buttplug.io/"><img src="https://avatars2.githubusercontent.com/u/39504077?s=200&v=4" width="32" height="32" /></a> Buttplug.io support
VAMLaunch now supports any device that is supported by Buttplug that accepts linear commands.
> Launch, Kiiroo Onyx 1/2/2.1, Titan 1, RealTouch
## VAM Modes

#### • New LaunchServer GUI
[qdot](https://github.com/qdot) has implemented a fantastic GUI interface to
setup connections with all your devices.
No more ugly command line server!

<img src="Docs/Images/VAMLaunchServerGUI.PNG" width="400"/>

#### • New Installer
The VAMLaunch now comes with an easy to use installer.

#### • New Motion Sources
There are new (and more reliable) ways to create device motion from within VAM, it really is possible now to achieve near 1:1 sync:

###### Oscillate Mode
### Oscillate Mode

[Instructions](Docs/OscilateMode.md)

Oscillate mode simply tells the device to move up and down at a certain speed, what makes this mode even more powerful is the ability to set an optional target AnimationPattern; VAMLaunch will take over this pattern and automatically adjust it's play time and speed to match the oscillation.

<img src="Docs/Images/osc_mode.gif" width="600"/>

##### AnimationPattern Mode
### AnimationPattern Mode

[Instructions](Docs/AnimationPatternMode.md)

AnimationPattern mode works like oscillation mode but in reverse. Instead of an oscillation driving a motion and pattern, a target pattern is driving the motion directly.

<img src="Docs/Images/pattern_mode.gif" width="600"/>

#### • Influence Zone Mode (Experimental)
### • Influence Zone Mode (Experimental)

[Instructions](Docs/InfluenceZoneMode.md)

Influence Zone Mode: The original mode is still here with some additional quality of life improvements. Zone mode enables motion by analysing the motion of an atom within a zone of influence. This mode is the least accurate of the three modes, but it is the most adaptable.

<img src="Docs/Images/zone_mode.gif" width="600"/>

#### • New trigger actions
### • New trigger actions
You can now make it easier for users of your scene to control their device through three new triggers:
- startLaunch
- stopLaunch
- toggleLaunch


### Installation
## Installation

Inside the .zip you will find two things:

Expand All @@ -76,7 +58,7 @@ Once this is installed, copy the VAMLaunch plugin folder to this location:

YOUR_VAM_LOCATION/Saves/Scripts

### Making sure your Launch device is ready
## Making sure your Launch device is ready

I highly suggest following the instructions [here](https://github.com/FredTungsten/ScriptPlayer/wiki/Installation)
and testing your device with ScriptPlayer first to confirm you have everything
Expand All @@ -85,21 +67,7 @@ set up correctly.
If your device can connect to ScriptPlayer then it is highly likely it will work
with this plugin.

### Connect Your Device

Before running VAM you will want to connect your device to the VAMLaunch server.

Open the VAMLaunch server application (Which will now be located where you installed it)

<img src="Docs/Images/devices.PNG" width="300"/>

The application should start searching immediately when it opens, in the case of the Launch device make sure it is on with the blue light flashing.
Once connected the blue light on your device should become solid and you will be able to view your device in the list.
Simply tick the device to enable it.

You are now ready to start using VAMLaunch within VAM!

### Starting The Plugin
## Starting The Plugin

VAMLaunch can be loaded onto any Atom in VAM. Simply select an Atom (In this case we have created a sphere Atom)

Expand All @@ -109,7 +77,7 @@ Go to the Plugins tab and press "Add Plugin", select the ADD_ME.cslist file foun

<img src="Docs/Images/loadplugin.PNG" width="600"/>

### Plugin Menu
## Plugin Menu

To open the plugin menu press "Open Custom UI" next to the VAMLaunch plugin in the list.

Expand Down

0 comments on commit 8675546

Please sign in to comment.