Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Readme
Music visualising framework based on WebGL and Web Audio API.
This project is still in early development stage, some APIs are likely to change. Please create a new issue if you find any bugs.
Akko's main purpose is to make writing music visualisers easy. It defines a robust, standardised framework for the task - you can focus on writing your visualiser without worrying about music playback, controls, or audio analysis. Once you're happy with your visualiser, you can put it into .js
file and publish it online for other Akko users to enjoy.
Akko uses WebGL and Web Audio API. This somewhat limits browser support, so you might want to check if it's supported in your browser: here for WebGL and here for Web Audio API.
The graphics component of Akko is based on three.js. This means you'll be using three.js to write your visualisers. There are tons of learning resources online and Akko comes with several default visualisers to help you get started (see lib/visualisers/
).
See the detailed API reference.
Example Akko setups are located in the examples/
folder. If you have Node.js installed, you can clone this repo then run npm install
and npm run examples
to start a local server. Alternatively, you could upload clone this repo to your own web server.
If you want to see what a simple Akko visualiser looks like, check out the lib/visualisers/
folder. Examples there are pretty basic, but remember that you have all three.js features at your disposal.
To try Akko, add it's JS and CSS files, as well as 2 of its external dependencies to your page. You might also have to set the height for Akko's container.
<!-- Akko's dependencies -->
<script src="https://cdn.jsdelivr.net/bluebird/latest/bluebird.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/86/three.min.js"></script>
<!-- Akko files -->
<link rel="stylesheet" href="path/to/akko.min.css"/>
<script src="path/to/akko.min.js"></script>
<!-- Set the height for Akko's container -->
<style>
#akko {
height: 500px;
}
</style>
Then, inside the <body>
of your page, create a <div>
container and launch Akko:
<div id="akko"></div>
<script>
var akko = new Akko();
akko.start();
</script>
You can now drag & drop an audio file into the visualiser to start playback. You could also use one of the input buttons in the menu in the top left of the screen. See Examples to learn how to define custom visualisers.
Alternatively, if you're using Node.js for your project:
npm install --save akko
Then:
const Akko = require('akko');
This project is still in its early development phase, so a lot of things are likely to change. If you want to extend the source code, please create a new issue so we can discuss the changes you want to make before you start.
All of the source code is written in ES6, except for some inline JS in the examples/
directory. For developers' convenience, npm run examples
and npm run watch
are provided, starting the local dev server and Webpack watchers respectively. When making a pull request, make sure npm run lint
returns no errors. Units and integrations tests coming soon.
FAQs
Music visualising framework based on WebGL and Web Audio API.
The npm package akko receives a total of 8 weekly downloads. As such, akko popularity was classified as not popular.
We found that akko demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.