Skip to content

Releases: KinectToVR/Amethyst-Releases

Amethyst v1.2.12.0

27 Feb 16:01
8c6878a
Compare
Choose a tag to compare

Amethyst v1.2.12.0

Short Commit ID: d33c2e7 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
Run amethyst-app:localize, tweak the strings, and PR them, here.

Changes

  • The trackers toggle button will no longer get stuck disabled until a reload hits
  • OSC plugin should not crash on OSC service reloads while sending pose data to VRChat
  • Embedded Kinect SDK msiexec installers should no more fail or time out
  • Calibration mode requirements are checked against both the service endpoint and the base device
  • Auto-spawn will retry (several times, if necessary) if failed or unavailable initially
  • PSMove poses will base forwarded unfiltered for improved overall tracking latency
  • Kinect for Xbox One (V2) should no longer enter the "Zombie mode" when connecting
  • Updated Windows App SDK to 1.4 for better stability and less user interface bugs

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us all the files collected by the app, from amethyst-app:report

Amethyst v1.2.8.0

09 Jan 18:16
f19b7e1
Compare
Choose a tag to compare

Amethyst v1.2.8.0

Short Commit ID: 284b9e (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
Run amethyst-app:localize, tweak the strings, and PR them, here.

Changes

  • The trackers toggle button will no longer get stuck disabled until a reload hits
  • OSC plugin should not crash on OSC service reloads while sending pose data to VRChat
  • Embedded Kinect SDK msiexec installers should no more fail or time out
  • Calibration mode requirements are checked against both the service endpoint and the base device
  • Auto-spawn will retry (several times, if necessary) if failed or unavailable initially
  • PSMove poses will base forwarded unfiltered for improved overall tracking latency
  • Kinect for Xbox One (V2) should no longer enter the "Zombie mode" when connecting
  • Updated Windows App SDK to 1.4 for better stability and less user interface bugs

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us all the files collected by the app, from amethyst-app:report

Amethyst v1.2.7.0

05 Jan 17:56
f19b7e1
Compare
Choose a tag to compare

Amethyst v1.2.7.0

Short Commit ID: da2b859 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
Run amethyst-app:localize, tweak the strings, and PR them, here.

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us all the files collected by the app, from amethyst-app:report

Amethyst v1.2.5.0

09 Aug 12:38
f19b7e1
Compare
Choose a tag to compare

Amethyst v1.2.5.0

Short Commit ID: 6b81338 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
Run amethyst-app:localize, tweak the strings, and PR them, here.

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us all the files collected by the app, from amethyst-app:report

Amethyst v1.2.1.4

15 Apr 20:42
f19b7e1
Compare
Choose a tag to compare

Amethyst v1.2.1.4

Short Commit ID: 69c94f5 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

Click here!

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

Changes:

  • Fixed joint, override, and device controls
  • More consequent update and store behaviour
  • Fixed manual calibration mode switching
  • Fixed calibration-time navigation blocker
  • Removed some unnecessary dependencies

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us the log files from %AppData%/Amethyst/logs

Amethyst v1.2.1.3

09 Apr 07:57
f19b7e1
Compare
Choose a tag to compare

Amethyst v1.2.1.3

Short Commit ID: 84d9ffc (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

Click here!

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

Changes:

  • 84d9ffc Fixed store's offline behavior (show errors instead of hanging)
  • b4e84eb Remove "Preview"
  • 1b4c0b6 Tweaked Azure Pipelines (and build) versioning
  • 83c4387 Better override notice tooltip, fix crashing with multiple overrides
  • f0ae02c Use the autogenerated build number provided by Azure
  • d21b979 Fix shutdown on older systems, acrylic support, OSC support
  • 3c9b9bf Fixed bugged joint and override selector expander controls (again)
  • fa3fc67 NUX changes, added new tips for the plugins/store page
  • df8f77a Removed the input stealing "fix" (already said to fixed by valve)
  • 3537c43 Bring to front before showing FirstShutdownTip
See More
  • cd34f92 Bumped versions, re-added the build script
  • 0a2d4a9 Merge branch 'curse' into main
  • 9c3450d Added sounds to all the new stuff
  • 2603b8f InfoPage sounds
  • 2af9119 Fluent NavigationView navigation icons
  • c944d0c Updated non-english string resource keys
  • 8d8e9e9 [Store] Moved XAML hardcoded strings to JSON
  • 5866d14 [Store] Unpack to %temp% instead of boiler plating the folder name
  • ace4ed8 [Store] Implement drag-and-drop (offline) installs
  • 2b87e95 [Store] Search from drag-and-drop links, text
  • da830c1 [Store] Install from search MVVM
  • 5dfc1a6 Responsive plugin uninstall flow
  • 0296887 Custom icons using JSON resources (because we can)
  • 2640911 [Store] Parse web link queries
  • aee21e1 Plugin store full search and uninstall functionality
  • ce5f7c0 GitHub device auth with proper token encryption
  • f89fc12 Fixed (most) broken event listeners
  • bb29ff0 Block subsequent close clicks while handling the exit
  • cdd6a88 Amethyst task scheduler 😳 (startup/shutdown, update/delete)
  • 9c5cda7 [Prototype] Plugin store prototype, responsive design layout
  • e271c91 Plugin downloads should have higher priority than base updates
  • 695cfc5 [Finished] Plugins auto-updater
  • 49562ef Respect the custom update API endpoint, always overwrite assets
  • d0decd1 Plugins updater prototype, update API endpoint metadata property
  • 5865260 [Prototype] Update-check for plugins (using metadata)
  • 00a2fe4 Responsive layout plugins manager, update notice prototype
  • 358e278 Removed the Azure Pipelines script
  • 48d90f1 Renamed TrackingDevices to AppPlugins
  • 3dd98ba [Stub] Plugins library manager page
  • ce79935 New updater UI using using InfoBars
  • f1de5fa Removed useless property change notification (WinRT COMException)
  • 5511ae6 Fixed OverrideExpander again
  • fbafe27 ActualThemeChanged should always reload all the NavigationView icons
  • 5c7e2a3 Automagic code reformat and cleanup
  • 1fa150d Better skeleton flip toggle/header text (using the device's name)
  • 91c9ec1 Use string.Format instead of Replace, it's there for a reason
  • 87d14a9 Version bump, AppData should use auto-properties
  • 63db1ab Fixed InvalidOperationException trying to remove invalid overrides
  • 1a54488 Fixed (?) No installed components were detected when using storyboards
  • af3f72d More verbose application startup logging
  • c30e87c Fixed ArgumentNullException crash on Devices.ReloadSelectedDevice
  • 271c0cb Resource strings hot reload for plugins (only current, valid resources)
  • c097cf0 Fixed double plugin registration (if failed on property scanning)
  • ed86237 Plugin loader tweaks: catch dummy paths and invalid junctions
  • b0d9142 Better dialog layout, selectable error text
  • 07859c6 Restart notice as an in-app InfoBar instead of a ...
Read more

Amethyst v1.1.0.0 Technical Preview (RC 2)

09 Nov 06:30
258b59e
Compare
Choose a tag to compare

Amethyst v1.1.0.0 Technical Preview (RC 2)

Short Commit ID: 4663ab4 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

How do I install or update Amethyst?

Click here!

I ran into a bug

Unless you're actually braindead, you may possibly have run into a bug,
Reporting those is important to building a stable application for release.
See just below on how to report bugs.

Want to help with translations?

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

Changes:

  • New server interface/API using gRPC
  • Devices may provide physics for prediction
  • Flip tweaks, use full playspace orientaion
  • Fixed crashes on brand new installs
  • Math-based orientation Mark 2
  • Way better overrides (both UI and backend)
  • PSMS uses SteamVR position prediction
  • Kinects only self-update to save CPU
  • Added a proper plugin/device manager
  • Multiple overrides are now possible
  • Localized VR Toasts, system Toasts
  • Proper widestring support for all languages
  • Per-device calibration and settings
  • More elements are generated with MVVM
  • Support device-provided language resources
  • New-User-Experience (TeachingTips)
  • Use mp4 MediaElement instead of gif
  • Way cuter calibration directions image
  • VR Admin check popout, blocking
  • Use MT libraries to prevent conflicts
Long version

4663ab4 Updated versions
38a8e56 Removed stale **predict PositionFilter ComboBox option
9017c98 Updated the ReRegister hint for new status codes
eccc28e Add GRPC to build instructions
84c4786 Made physics optional, removed 'prediction' filters
44af41f Added checking, parsing and displaying server & RPC statuses
00fc4b9 Finished IPC rewrite to gRPC (API, Driver, Amethyst)
b79d379 Added gRPC server implementation, stub client API
b8a1fb8 Moved orientation calibration to the { get; } module of K2AppTracker
e97efab Added previous pose components caching
966dfc5 Fixed flip not using playspace definitions
02cbbf1 Updated API versions, added pose caching
d58d6f9 Removed timestamps from the server API protocol
07cd583 Stub internal tracker physics
f817687 Fixed FS crashing on new/clear-appdata installs
a69a10b Merge remote-tracking branch 'origin/math-based-v2' into main
46ae29e Updated flip logic, added stub position prediction filter
edaf7d6 Cleanup
9776649 Implement Math based v2
1e2f481 Move IsJointOverriden to utils
6bde4b9 Better tracker override check scheme
fb9adf5 Added pose (std & prev) timestamp handling, copying and (sample) usage
5071c3d PSMS handler tweaks
528e78c Add 'previous' pose timestamp caching to joints
09f93b5 Kinect V1: Force self-update, wait for new frames instead of spamming w/ updates (cpu)
55062b0 Kinect V2: Force self-update, wait for new frames instead of spamming w/ updates (cpu)
e41e4be PSMS: Use controller-provided physics
1f96692 Fixed wrong pane corner radiuses (GeneralPage)
90f3a21 Updated Amethyst to WASDK1.2-2
7f63599 Use -> instead of .get()-> [pretty-code]
f6b0767 Updated the crash handler to WASDK1.2-2
7238bf8 Updated Eigen runtime definitions
e09aa20 Fix doubled sounds in some places
4832aea Merge pull request #4 from KinectToVR/plugin-manager
33f0408 Added building precautions to the build readme
b45465a Added, updated the app strings for the pending changes (not translated)
edd1a61 Fixed the restart notice hiding on outside clicks
dc06622 Added plugins repeater view w/ backend and hot reload
c657fa9 Cache all plugin load results into a vector (name/guid/result/location)
03eb00d Minor code/solution updates
ba96ade Added disabled devices vector/set to savable settings
eeae8ee Fixed some things (VR Toasts) not being displayed properly
3aabc8a Fixed wrong TeachingTip zindex/context
ae1f7fd Added plugin manager MVVM files
547f72e Fixed strings hot reload crashing Amethyst occasionally
d4d89e8 Don't dim the calibration button if it's already disabled
4da70e9 Calibration button opacity transition
54b3b6e Don't call the reference origin position 'waist,' as it's not exactly 'waist'
bf237ec Amethyst devices API device self-update option
c1e74bc Merge pull request #3 from KinectToVR/calibration-lock
[511b4a5](KinectToVR/Amethyst@511b4a5...

Read more

Amethyst Technical Preview (v1.0.3.0)

30 Aug 17:33
8af08a3
Compare
Choose a tag to compare

Amethyst v1.0.3.0 Technical Preview (RC 1)

Short Commit ID: 1cce2c4 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

Setup instructions are also available on discord
For help with, please hit 公彦赤屋先#5023 or #development

Pre-requisites (You need these to run the app):

Actually doing the thing:

  • Download Amethyst-Release-XXXXXXX.zip
  • Create a new folder, e.g. C:\Amethyst
  • Extract the ZIP into that new folder.
    In the case of the example folder, you would end up with C:\Amethyst\Amethyst.exe
  • Once Amethyst is launched, Click re-register SteamVR driver and follow the prompts.
  • ezgif com-gif-maker(7)

It's unsupported but please help me anyway!!!

My SteamVR gives me Error 203 and won't start no matter what I do.

You have the Amethyst and K2EX drivers enabled at the same time.
They use the same logging library and conflict with each other on startup, causing the entirety of the SteamVR backend to crash.
Close SteamVR, then either delete or edit %localappdata%\openvr\openvrpaths.vrpath
if your file says null in it after you edited it, go learn JSON, and WTF are you doing on GitHub????

I have some other unrelated issue.

Unless you're actually braindead, you may possibly have run into a bug,
reporting those is important to building a stable application for release.
See just below on how to report bugs.

Time for your move:

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

You can register VR manifests and enable AutoStart with SteamVR inside Amethyst.

Changes:

  • Light theme shouldn't now break the app! (Fixed calibration/offsets/device-settings/...)
  • Both the server driver and the API have been rewritten to use Google Protocol Buffers.
    • Amethyst should react even faster (note: Kinect is still operating at 30Hz!)

      Reason: Protobuf is faster, and we don't need to HEX-encode everything

    • Decrease in badly formatted/parsed messages - less errors should happen
    • Higher config/version mismatch tolerance (sometimes helps in debugging)
  • Amethyst now uses the native Win32 http client class for networking
  • Settings are handled by cereal, this should hopefully fix often config breaks
  • Filesystem handlers are operated by STL, this should decrease possible errors
  • Various string changes and interface stability updates

What's with that RC?

Amethyst has entered its Release Candidate state.
This means devs are bored so much they randomy rewrite half of the app.
the next builds are only gonna become more and more stable and fixed,
and that their backend/interfacing code is finally robust enough (...maybe)

Due to pending API changes, this release may be one of the last PREVIEW ones.

Note: it doesn't mean that a stable is near, it means we're only preparing for it

Pending critical changes:

  • Releases checked with K2VR Web API and updated with the installer
    • Internal-external automatic Amethyst app updater
  • New, super-cute automatic calibration image w/ directions
  • New User Experience w/ TeachingTips and app-state-aware flyouts

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us the log files from %AppData%/Amethyst/logs

Amethyst Technical Preview (v1.0.2.13)

26 Aug 19:33
8af08a3
Compare
Choose a tag to compare

Amethyst v1.0.2.13 Technical Preview

Short Commit ID: 9e34c6f (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

Setup instructions are also available on discord
For help with, please hit 公彦赤屋先#5023 or #development

Pre-requisites (You need these to run the app):

Actually doing the thing:

  • Download Amethyst-Release-XXXXXX.zip
  • Create a new folder, e.g. C:\Amethyst
  • Extract the ZIP into that new folder.
    In the case of the example folder, you would end up with C:\Amethyst\Amethyst.exe
  • Once Amethyst is launched, Click re-register SteamVR driver and follow the prompts.
  • ezgif com-gif-maker(7)

It's unsupported but please help me anyway!!!

My SteamVR gives me Error 203 and won't start no matter what I do.

You have the Amethyst and K2EX drivers enabled at the same time.
They use the same logging library and conflict with each other on startup, causing the entirety of the SteamVR backend to crash.
Close SteamVR, then either delete or edit %localappdata%\openvr\openvrpaths.vrpath
if your file says null in it after you edited it, go learn JSON, and WTF are you doing on GitHub????

I have some other unrelated issue.

Unless you're actually braindead, you may possibly have run into a bug,
reporting those is important to building a stable application for release.
See just below on how to report bugs.

Time for your move:

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

Important:

Described upper, Amethyst is now being slowly localized.
If pages are loading way slower than they should, please:

  1. Ignore that, it may be fixed soon enough
  2. Consider buying a faster/better drive

You can register VR manifests and enable AutoStart with SteamVR inside Amethyst.

Changes after v1.0.2.12 (akaya's too lazy to write, again, again, again):

e37aa38 Updated licenses
21a0774 Version bump
01c148c New DevicesPage icon (at least for now)
6436f7f Better theming support: device-provided settings
fb4b17a Updated strings: owoTrackVR NoPorts error

Changes after v1.0.2.11 (akaya's too lazy to write, again, again):

9e34c6f Theming-related fixes and interface redesigns
d8bbd6b Updated licenses
15a8ed0 Don't autodisable override expanders (they'll display 'joint disabled' instead)
2ff00b7 Width autoadjust fixes in the devices tab
cd36856 (HMM) 'Joint enum' appears not to be equal to 'tracker enum'
21fec17 Incremented the version for the next release
6ef622a [Okashi] Use unicode escapes instead of a hardcoded string
a2a1d0b [Credits] Use a shared container with 'Auto' widths for spacing
2621c82 Stripped the resource strings (removed front/back spaces)
19009bb ConsolePage margin/offset fixes
ad8bdeb Fixed spawn (ToggleTrackers) wring content after page reload
6af5535 Actions should be sentence-cased (Updates)
146333c Fixed spawn (ToggleTrackers) not retaining its state after page reload
7e9392f Freeze (ToggleTracking) sounds should be inverted
6a6bb53 Language & Theme comboboxes sounds
dddb5c3 Added a manual update trigger test
8284b6c Updated French translation [^Ella]

Changes after v1.0.2.10 (akaya's too lazy to write, again):

22a89a9 Fixed update-on-exit logic (a bit)
adb0990 WinAppSDK back to stable (Fixes view styles)
2ff71a6 WinAppSDK 1.2-exp1 & custom notifications
c60a047 Updated submodule external/openvr
52e3158 Updated translators
d285c5b Updated localization and related layout errors
fc8ad73 Updated localization resources (layout)
aaf1142 'Update on exit' instead of 'Skip', handler
f4fd8ec Updated localization resources (finished)
927832c First rebuild, then reload (DevicesPage)
37d43aa Refresh device settings UI (trick the device into reloading) on language change
3839aa6 Updated localization resources
935978c Refresh trackers|joint|override expanders after a language change too
2e15aed Links should now point to the localized (w/ checks) Amethyst docs
ddd5094 Refresh server status on page reloads
153349b Control tracking state labels' opacity directly (flash on startup fixed)
7693af4 Added a fancy language icon
f7c8769 Removed embedded Crash Handler strings (replaced with JSON)
f7b38bb Verify the desired language exists prior to loading, print a bit more logs.
f8f3999 Updated licenses
bf6c078 Moved OWO's resources to AME's JSON string resources
883126d Moved devices' resources to AME's JSON string resources
e1f9498 Added API methods to get the selected language & JSON strings
cd0bee1 Moved Crash Handler's resources to AME's JSON string resources
bc09f2c Added a hot reload for JSON string resources
bfa5995 Override window decoration colors according to the selected theme
ae85182 AutoMagic code reformat (ReSharper)
6bb5bf3 (Kinda) Finished the theme switcher
20b1b97 Custom attention & neutral brush overrides
43cd339 Partial theme resources rework (fixes inverted colors & broken colors)
c42d315 Implemented a basic theme switcher
b3db985 Cache the current page's class, update icons on MainWindow reload
727e953 Added page reload methods with remote watchdogs
00076ec Added a basic language & theme picker, partially reworked settings UI
6b7f505 JSON localization setup at _Loaded() [Dynamically generated elements]
03c8e00 Added localization { get; } methods, added a basic locale enumeration
5d053df Moved English strings to a basic JSON resource
[Multiple] JSON localization setup at _Loaded() [Multiple]
835291c Updated de-DE translations
0e186b1 Incremented the version for the next release
b24f4cc STL happened to be supreme to boost (again)
240a8c3 Finished the licenses flyout, added update flyout guard
97ce872 Added a licenses view (ChungusBungus model-like), localized the prev commit changes
d1df7d7 Added tracking/inferred labels to the skeleton preview
3452fe5 New, cuter, better and more satisfying app sounds
781f8b4 MainWindow sounds
1026b85 Shared interface sounds
963a36e InfoPage sounds
ee257c8 DevicesPage sounds
c1cc943 SettingsPage sounds
2a6b7be GeneralPage sounds
430f974 Calibration sounds & faster cancel/abort
8883e04 Disable the ElementSoundPlayer
b5c0963 Added a base sound player to replace the ElementSoundPlayer
082e19c Allow for playing sounds while in the background (uap3)
c49befb Enabled theming automagic for the AppTitle
8494f84 Added custom sound files to the solution

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us the log files from %AppData%/Amethyst/logs

Amethyst Technical Preview (v1.0.2.12)

25 Aug 13:03
Compare
Choose a tag to compare

Amethyst v1.0.2.12 Technical Preview

Short Commit ID: d8bbd6 (Amethyst)

In case you wanted to know what's changed since 0.9...
Better ask what's NOT been changed. But that'd be stupid
Anyway, there's a simple somewhat-of-a-changelog, here

Setup instructions are also available on discord
For help with, please hit 公彦赤屋先#5023 or #development

Pre-requisites (You need these to run the app):

Actually doing the thing:

  • Download Amethyst-Release-XXXXXX.zip
  • Create a new folder, e.g. C:\Amethyst
  • Extract the ZIP into that new folder.
    In the case of the example folder, you would end up with C:\Amethyst\Amethyst.exe
  • Once Amethyst is launched, Click re-register SteamVR driver and follow the prompts.
  • ezgif com-gif-maker(7)

It's unsupported but please help me anyway!!!

My SteamVR gives me Error 203 and won't start no matter what I do.

You have the Amethyst and K2EX drivers enabled at the same time.
They use the same logging library and conflict with each other on startup, causing the entirety of the SteamVR backend to crash.
Close SteamVR, then either delete or edit %localappdata%\openvr\openvrpaths.vrpath
if your file says null in it after you edited it, go learn JSON, and WTF are you doing on GitHub????

I have some other unrelated issue.

Unless you're actually braindead, you may possibly have run into a bug,
reporting those is important to building a stable application for release.
See just below on how to report bugs.

Time for your move:

We're currently localizing (translating) Amethyst, crash handler and devices.
If you know (or someone, you know, knows?) more languages than English
(preferably intermediate), please consider committing to the project.
You can find the instructions, FAQ, and files here

Important:

Described upper, Amethyst is now being slowly localized.
If pages are loading way slower than they should, please:

  1. Ignore that, it may be fixed soon enough
  2. Consider buying a faster/better drive

You can register VR manifests and enable AutoStart with SteamVR inside Amethyst.

Changes after v1.0.2.11 (akaya's too lazy to write, again, again):

d8bbd6b Updated licenses
15a8ed0 Don't autodisable override expanders (they'll display 'joint disabled' instead)
2ff00b7 Width autoadjust fixes in the devices tab
cd36856 (HMM) 'Joint enum' appears not to be equal to 'tracker enum'
21fec17 Incremented the version for the next release
6ef622a [Okashi] Use unicode escapes instead of a hardcoded string
a2a1d0b [Credits] Use a shared container with 'Auto' widths for spacing
2621c82 Stripped the resource strings (removed front/back spaces)
19009bb ConsolePage margin/offset fixes
ad8bdeb Fixed spawn (ToggleTrackers) wring content after page reload
6af5535 Actions should be sentence-cased (Updates)
146333c Fixed spawn (ToggleTrackers) not retaining its state after page reload
7e9392f Freeze (ToggleTracking) sounds should be inverted
6a6bb53 Language & Theme comboboxes sounds
dddb5c3 Added a manual update trigger test
8284b6c Updated French translation [^Ella]

Changes after v1.0.2.10 (akaya's too lazy to write, again):

22a89a9 Fixed update-on-exit logic (a bit)
adb0990 WinAppSDK back to stable (Fixes view styles)
2ff71a6 WinAppSDK 1.2-exp1 & custom notifications
c60a047 Updated submodule external/openvr
52e3158 Updated translators
d285c5b Updated localization and related layout errors
fc8ad73 Updated localization resources (layout)
aaf1142 'Update on exit' instead of 'Skip', handler
f4fd8ec Updated localization resources (finished)
927832c First rebuild, then reload (DevicesPage)
37d43aa Refresh device settings UI (trick the device into reloading) on language change
3839aa6 Updated localization resources
935978c Refresh trackers|joint|override expanders after a language change too
2e15aed Links should now point to the localized (w/ checks) Amethyst docs
ddd5094 Refresh server status on page reloads
153349b Control tracking state labels' opacity directly (flash on startup fixed)
7693af4 Added a fancy language icon
f7c8769 Removed embedded Crash Handler strings (replaced with JSON)
f7b38bb Verify the desired language exists prior to loading, print a bit more logs.
f8f3999 Updated licenses
bf6c078 Moved OWO's resources to AME's JSON string resources
883126d Moved devices' resources to AME's JSON string resources
e1f9498 Added API methods to get the selected language & JSON strings
cd0bee1 Moved Crash Handler's resources to AME's JSON string resources
bc09f2c Added a hot reload for JSON string resources
bfa5995 Override window decoration colors according to the selected theme
ae85182 AutoMagic code reformat (ReSharper)
6bb5bf3 (Kinda) Finished the theme switcher
20b1b97 Custom attention & neutral brush overrides
43cd339 Partial theme resources rework (fixes inverted colors & broken colors)
c42d315 Implemented a basic theme switcher
b3db985 Cache the current page's class, update icons on MainWindow reload
727e953 Added page reload methods with remote watchdogs
00076ec Added a basic language & theme picker, partially reworked settings UI
6b7f505 JSON localization setup at _Loaded() [Dynamically generated elements]
03c8e00 Added localization { get; } methods, added a basic locale enumeration
5d053df Moved English strings to a basic JSON resource
[Multiple] JSON localization setup at _Loaded() [Multiple]
835291c Updated de-DE translations
0e186b1 Incremented the version for the next release
b24f4cc STL happened to be supreme to boost (again)
240a8c3 Finished the licenses flyout, added update flyout guard
97ce872 Added a licenses view (ChungusBungus model-like), localized the prev commit changes
d1df7d7 Added tracking/inferred labels to the skeleton preview
3452fe5 New, cuter, better and more satisfying app sounds
781f8b4 MainWindow sounds
1026b85 Shared interface sounds
963a36e InfoPage sounds
ee257c8 DevicesPage sounds
c1cc943 SettingsPage sounds
2a6b7be GeneralPage sounds
430f974 Calibration sounds & faster cancel/abort
8883e04 Disable the ElementSoundPlayer
b5c0963 Added a base sound player to replace the ElementSoundPlayer
082e19c Allow for playing sounds while in the background (uap3)
c49befb Enabled theming automagic for the AppTitle
8494f84 Added custom sound files to the solution

Reports:

  • Record the issue (or at least describe it as well as you can)
  • Send us the log files from %AppData%/Amethyst/logs