Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicolasperez19/mic-master-flex
MicMasterFlex is a web app that allows users to configure the positions of a microphone array on an interactive grid. Designed for audio engineers and researchers, this tool offers an intuitive interface for precise microphone placement, enabling users to simulate and optimize array setups for various acoustic applications.
https://github.com/nicolasperez19/mic-master-flex
ai astro audio-processing grid-configuration microphone-array numpy numpy-arrays react robotics tailwindcss typescript
Last synced: 15 days ago
JSON representation
MicMasterFlex is a web app that allows users to configure the positions of a microphone array on an interactive grid. Designed for audio engineers and researchers, this tool offers an intuitive interface for precise microphone placement, enabling users to simulate and optimize array setups for various acoustic applications.
- Host: GitHub
- URL: https://github.com/nicolasperez19/mic-master-flex
- Owner: nicolasperez19
- Created: 2024-10-25T01:29:02.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-25T04:38:52.000Z (2 months ago)
- Last Synced: 2024-10-27T15:18:16.928Z (2 months ago)
- Topics: ai, astro, audio-processing, grid-configuration, microphone-array, numpy, numpy-arrays, react, robotics, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://nicolasperez19.github.io/mic-master-flex/
- Size: 4.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
🎙️MicMasterFlex
MicMasterFlex is a web app that allows users to configure the positions of a microphone array on an interactive grid.
Designed for audio engineers and researchers, this tool offers an intuitive interface for precise microphone placement, enabling users to simulate and optimize array setups for various acoustic applications.
# Table of Contents
1. [Demo](#demo)
2. [Project motivation](#project-motivation)
3. [Prerequisites](#prerequisites)
4. [Installation](#installation)
5. [Running the project locally](#running-the-project-locally)
6. [Building the project locally](#building-the-project-locally)
7. [Project structure](#project-structure)
8. [Citation](#citation)
## 📸 Demo
https://github.com/user-attachments/assets/419bda8b-d6a5-4f54-87b8-acef9d752226
## 💡 Project Motivation
**MicMasterFlex** was born out of challenges encountered during the [*Robots as Furniture*](https://github.com/robotsasfurniture/passive-sound-localization) project at [Brown University Human-centered Robotics Initiative](https://hcri.brown.edu/), where configuring a microphone array for sound localization required precise positioning of multiple microphones.
Given the complex arrangement, writing down positions manually without a visual guide proved inefficient and error-prone.
MicMasterFlex addresses this by offering an interactive, visual interface to configure microphone positions on a grid, making it easier to plan and visualize the array layout.
Additionally, the tool generates the necessary `numpy` code for these positions, streamlining the setup process for audio processing and sound localization tasks.
## 📋 Prerequisites
In order to run the project locally, you must have [Bun runtime](https://bun.sh/) installed.
## 💾 Installation
To install the project locally, clone the git repository and install all dependencies by running the following commands in your terminal:
```sh
git clone https://github.com/nicolasperez19/mic-master-flex.git
cd mic-master-flex
bun install
```
## 🏃♂️💨 Running the Project Locally
To run the project locally in developer mode, run the following command in your terminal:
```sh
bun run dev
```
## 🏗️ Building the Project Locally
To build the project locall, run the following command in your terminal:
```sh
bun run build
```
The production version of the site will be available in the `./dist` folder.
## 🚀 Project Structure
Inside of your Astro project, you'll see the following folders and files:
```text
/
├── public/
│ └── favicon.svg
├── src/
│ ├── components/
│ │ └── Card.astro
│ ├── layouts/
│ │ └── Layout.astro
│ └── pages/
│ └── index.astro
└── package.json
```
Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
Any static assets, like images, can be placed in the `public/` directory.
## 📝 Citation
If you'd like to cite this project, please use this BibTex:
```
@article{perez2024micmasterflex,
title={MicMasterFlex},
author={Nicolas Perez},
journal={https://example.com/},
year={2024}
}
```