Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kfarr/aframe-notecards

Notecards in VR
https://github.com/kfarr/aframe-notecards

Last synced: 14 days ago
JSON representation

Notecards in VR

Awesome Lists containing this project

README

        

# aframe-notecards
## Notecards in VR for processing your thoughts



Try it out now: https://kfarr.github.io/aframe-notecards/

This app takes a Google Sheet with a column named "Idea" and creates virtual notecards randomly placed in a scene. Using the Vive controls you can grab and move the cards around to organize them around common themes.

## How to use:
* `git clone` this project and run your favorite local webserver, or try the [online demo here](http://kfarr.github.io/aframe-notecards/)
* Click "(1) Load Cards from Sheet"
* Then click "(2) Update Collider and Close"
* Enter VR mode with a [WebVR](http://webvr.info) compatible browser
* Organize your thoughts by grabbing them and moving them around

## How to prepare your own Google Sheet
* [Copy this spreadsheet](https://docs.google.com/spreadsheets/d/1FdjSF9zsBiOJYf40hqDXRfEbqZ7nveMP0t6nN86rLNU/edit?usp=sharing), or just create a brand new spreadsheet with a column header of "Idea".
* Make sure the Google Sheet is "published": click on File > Publish to the Web... > Publish
* Copy the Google Sheet URL and paste it into the text box.
* Click "(1) Load Cards from Sheet"
* Then click "(2) Update Collider and Close"

## Known issues / to-do items:
* Add ability to create "theme labels" using https://github.com/ngokevin/kframe/tree/master/components/text. During the feedback parsing process it can be helpful to place the notecards around the common theme labels.
* The aframe text component (https://github.com/bryik/aframe-bmfont-text-component) looks blurry and aliased with small text in the distance, such as this very use case. Rendering text to an image texture results in higher quality text but is not nearly as easy as using the text component when using dynamic sources such as Google Sheets. The "real" solution is to improve the quality of the BMFont a-frame component. It may be possible to "re-render" a font with settings optimized for viewing from a distance or to improve the BMFont shader. More reading on this topic: ** https://github.com/Jam3/three-bmfont-text
** https://github.com/Jam3/msdf-bmfont
** https://threejs.org/docs/api/textures/Texture.html > try alternate texture minFilter
** https://github.com/bryik/aframe-bmfont-text-component/blob/master/lib/shaders/sdf.js
* Better error handling when Google Sheet cannot be parsed
* Would be nice to save the location of the cards for future sessions
* Would be nice to have collaboration features to work remotely with a colleague
* If we have "theme labels" it'd be cool to retroactively update the Google Sheet so that each Idea row has a new column "Theme" populated by the theme label with the closet proximity to the notecard. Then your work in VR can update the sheet itself.
* the code is very ugly

DONE
* UI to allow for end-user to copy/paste google sheet URL before entering VR mode