README
¶
Notendo Tunes
Notendo Tunes is our attempt at creating a virtual theremin in the browser for Aston Hack 2018. Of course, that would be too easy, so we've made it controllable using Nintendo JoyCons. Cause that sounded like a fun idea at 2pm before we actually started working.
A quick demo video (click to open)
We think it's pretty cool, and apparently so did everyone else, because we won the best hack out of all the other projects! Despite the fact that we decided to test our synthesizers at 3am, probably annoying everyone else.
Process
As it turns out, getting JoyCons to work in the browser is actually not very easy (surprise, surprise). So, we hacked an existing driver to interpret motion controls and present them to the Web Gamepad API.
In the browser we have a Web Audio API generating sounds and an HTML5 canvas displaying visualisations. And somehow it all works. Barely...
Team
The team that worked on this was:
Tools
The project was developed in HTML5 and Go. We used webpack as a build system, and heavily utilized the javascript audio and game controller APIs. We also used the HTML5 canvas for the visualisations.
We heavily hacked the joycon driver so that we could use the motion controls in the browser. The driver for the joycons was originally developed by Kane York here.
Development
Webpage
To install the project:
$ git clone https://github.com/jedevc/aston-hack-2018.git
$ cd aston-hack-2018
$ npm install
To test the project:
$ npm run start
The server will then be listening on port 8080. Use chrome. And nothing else.
JoyCon Driver (Linux only)
To start the driver
$ chmod +x jcdriver
$ sudo ./jcdriver
License
All the code written by us is available under the MIT license.
Directories
¶
| Path | Synopsis |
|---|---|
|
driver
|
|
|
go/src/github.com/chzyer/readline
Readline is a pure go implementation for GNU-Readline kind library.
|
Readline is a pure go implementation for GNU-Readline kind library. |
|
go/src/github.com/chzyer/readline/example/readline-pass-strength
This is a small example using readline to read a password and check it's strength while typing using the zxcvbn library.
|
This is a small example using readline to read a password and check it's strength while typing using the zxcvbn library. |
|
go/src/github.com/chzyer/readline/runes
deprecated.
|
deprecated. |
|
go/src/github.com/pkg/errors
Package errors provides simple error handling primitives.
|
Package errors provides simple error handling primitives. |
|
go/src/github.com/riking/joycon/prog4/bluez
bluez package handles interaction with dbus for Bluetooth discovery on Linux.
|
bluez package handles interaction with dbus for Bluetooth discovery on Linux. |
|
go/src/github.com/riking/joycon/prog4/jcpc
Package jcpc (Joy-Con PC) contains constants, interface definitions, and short utility functions for the joy-con driver.
|
Package jcpc (Joy-Con PC) contains constants, interface definitions, and short utility functions for the joy-con driver. |
|
go/src/golang.org/x/net/bpf
Package bpf implements marshaling and unmarshaling of programs for the Berkeley Packet Filter virtual machine, and provides a Go implementation of the virtual machine.
|
Package bpf implements marshaling and unmarshaling of programs for the Berkeley Packet Filter virtual machine, and provides a Go implementation of the virtual machine. |
|
go/src/golang.org/x/net/context
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.
|
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes. |
|
go/src/golang.org/x/net/context/ctxhttp
Package ctxhttp provides helper functions for performing context-aware HTTP requests.
|
Package ctxhttp provides helper functions for performing context-aware HTTP requests. |
|
go/src/golang.org/x/net/dict
Package dict implements the Dictionary Server Protocol as defined in RFC 2229.
|
Package dict implements the Dictionary Server Protocol as defined in RFC 2229. |
|
go/src/golang.org/x/net/dns/dnsmessage
Package dnsmessage provides a mostly RFC 1035 compliant implementation of DNS message packing and unpacking.
|
Package dnsmessage provides a mostly RFC 1035 compliant implementation of DNS message packing and unpacking. |
|
go/src/golang.org/x/net/html
Package html implements an HTML5-compliant tokenizer and parser.
|
Package html implements an HTML5-compliant tokenizer and parser. |
|
go/src/golang.org/x/net/html/atom
Package atom provides integer codes (also known as atoms) for a fixed set of frequently occurring HTML strings: tag names and attribute keys such as "p" and "id".
|
Package atom provides integer codes (also known as atoms) for a fixed set of frequently occurring HTML strings: tag names and attribute keys such as "p" and "id". |
|
go/src/golang.org/x/net/html/charset
Package charset provides common text encodings for HTML documents.
|
Package charset provides common text encodings for HTML documents. |
|
go/src/golang.org/x/net/http/httpguts
Package httpguts provides functions implementing various details of the HTTP specification.
|
Package httpguts provides functions implementing various details of the HTTP specification. |
|
go/src/golang.org/x/net/http/httpproxy
Package httpproxy provides support for HTTP proxy determination based on environment variables, as provided by net/http's ProxyFromEnvironment function.
|
Package httpproxy provides support for HTTP proxy determination based on environment variables, as provided by net/http's ProxyFromEnvironment function. |
|
go/src/golang.org/x/net/http2
Package http2 implements the HTTP/2 protocol.
|
Package http2 implements the HTTP/2 protocol. |
|
go/src/golang.org/x/net/http2/h2c
Package h2c implements the unencrypted "h2c" form of HTTP/2.
|
Package h2c implements the unencrypted "h2c" form of HTTP/2. |
|
go/src/golang.org/x/net/http2/h2i
The h2i command is an interactive HTTP/2 console.
|
The h2i command is an interactive HTTP/2 console. |
|
go/src/golang.org/x/net/http2/hpack
Package hpack implements HPACK, a compression format for efficiently representing HTTP header fields in the context of HTTP/2.
|
Package hpack implements HPACK, a compression format for efficiently representing HTTP header fields in the context of HTTP/2. |
|
go/src/golang.org/x/net/icmp
Package icmp provides basic functions for the manipulation of messages used in the Internet Control Message Protocols, ICMPv4 and ICMPv6.
|
Package icmp provides basic functions for the manipulation of messages used in the Internet Control Message Protocols, ICMPv4 and ICMPv6. |
|
go/src/golang.org/x/net/idna
Package idna implements IDNA2008 using the compatibility processing defined by UTS (Unicode Technical Standard) #46, which defines a standard to deal with the transition from IDNA2003.
|
Package idna implements IDNA2008 using the compatibility processing defined by UTS (Unicode Technical Standard) #46, which defines a standard to deal with the transition from IDNA2003. |
|
go/src/golang.org/x/net/internal/iana
Package iana provides protocol number resources managed by the Internet Assigned Numbers Authority (IANA).
|
Package iana provides protocol number resources managed by the Internet Assigned Numbers Authority (IANA). |
|
go/src/golang.org/x/net/internal/nettest
Package nettest provides utilities for network testing.
|
Package nettest provides utilities for network testing. |
|
go/src/golang.org/x/net/internal/socket
Package socket provides a portable interface for socket system calls.
|
Package socket provides a portable interface for socket system calls. |
|
go/src/golang.org/x/net/internal/socks
Package socks provides a SOCKS version 5 client implementation.
|
Package socks provides a SOCKS version 5 client implementation. |
|
go/src/golang.org/x/net/internal/sockstest
Package sockstest provides utilities for SOCKS testing.
|
Package sockstest provides utilities for SOCKS testing. |
|
go/src/golang.org/x/net/internal/timeseries
Package timeseries implements a time series structure for stats collection.
|
Package timeseries implements a time series structure for stats collection. |
|
go/src/golang.org/x/net/ipv4
Package ipv4 implements IP-level socket options for the Internet Protocol version 4.
|
Package ipv4 implements IP-level socket options for the Internet Protocol version 4. |
|
go/src/golang.org/x/net/ipv6
Package ipv6 implements IP-level socket options for the Internet Protocol version 6.
|
Package ipv6 implements IP-level socket options for the Internet Protocol version 6. |
|
go/src/golang.org/x/net/nettest
Package nettest provides utilities for network testing.
|
Package nettest provides utilities for network testing. |
|
go/src/golang.org/x/net/netutil
Package netutil provides network utility functions, complementing the more common ones in the net package.
|
Package netutil provides network utility functions, complementing the more common ones in the net package. |
|
go/src/golang.org/x/net/proxy
Package proxy provides support for a variety of protocols to proxy network data.
|
Package proxy provides support for a variety of protocols to proxy network data. |
|
go/src/golang.org/x/net/publicsuffix
Package publicsuffix provides a public suffix list based on data from https://publicsuffix.org/
|
Package publicsuffix provides a public suffix list based on data from https://publicsuffix.org/ |
|
go/src/golang.org/x/net/route
Package route provides basic functions for the manipulation of packet routing facilities on BSD variants.
|
Package route provides basic functions for the manipulation of packet routing facilities on BSD variants. |
|
go/src/golang.org/x/net/trace
Package trace implements tracing of requests and long-lived objects.
|
Package trace implements tracing of requests and long-lived objects. |
|
go/src/golang.org/x/net/webdav
Package webdav provides a WebDAV server implementation.
|
Package webdav provides a WebDAV server implementation. |
|
go/src/golang.org/x/net/webdav/internal/xml
Package xml implements a simple XML 1.0 parser that understands XML name spaces.
|
Package xml implements a simple XML 1.0 parser that understands XML name spaces. |
|
go/src/golang.org/x/net/websocket
Package websocket implements a client and server for the WebSocket protocol as specified in RFC 6455.
|
Package websocket implements a client and server for the WebSocket protocol as specified in RFC 6455. |
|
go/src/golang.org/x/net/xsrftoken
Package xsrftoken provides methods for generating and validating secure XSRF tokens.
|
Package xsrftoken provides methods for generating and validating secure XSRF tokens. |
|
go/src/golang.org/x/sys/cpu
Package cpu implements processor feature detection for various CPU architectures.
|
Package cpu implements processor feature detection for various CPU architectures. |
|
go/src/golang.org/x/sys/unix
Package unix contains an interface to the low-level operating system primitives.
|
Package unix contains an interface to the low-level operating system primitives. |
|
go/src/golang.org/x/sys/windows/svc
Package svc provides everything required to build Windows service.
|
Package svc provides everything required to build Windows service. |
|
go/src/golang.org/x/sys/windows/svc/debug
Package debug provides facilities to execute svc.Handler on console.
|
Package debug provides facilities to execute svc.Handler on console. |
|
go/src/golang.org/x/sys/windows/svc/eventlog
Package eventlog implements access to Windows event log.
|
Package eventlog implements access to Windows event log. |
|
go/src/golang.org/x/sys/windows/svc/example
Example service program that beeps.
|
Example service program that beeps. |
|
go/src/golang.org/x/sys/windows/svc/mgr
Package mgr can be used to manage Windows service programs.
|
Package mgr can be used to manage Windows service programs. |
Click to show internal directories.
Click to hide internal directories.