Skip to content

README.md

Latest commit

 

History

History
74 lines (54 loc) · 2.84 KB

README.md

File metadata and controls

74 lines (54 loc) · 2.84 KB

Limitless Aether - Audio Exporter

A powerful tool to export your audio memories (lifelogs) from the Limitless.ai platform. This application allows you to bulk download your audio recordings, bypassing browser memory limitations by streaming files directly to your local disk.

Features

  • Bulk Extraction: Download recordings for a single day, a specific date range, or an entire month.
  • Smart Rate Limiting: Automatically handles API rate limits (429 errors) and throttles requests to ensure stability (respecting the 180 req/min limit).
  • Direct-to-Disk Saving: Uses a local proxy server to save audio files directly to your computer, avoiding browser crashes when downloading large amounts of data (e.g., a full month of audio).
  • Organized Output: Files are saved with descriptive names (e.g., 2024-05-20_Monday.ogg) in the downloads folder.
  • Modern UI: Built with React and Tailwind CSS for a smooth user experience.

Prerequisites

  • Node.js: Ensure you have Node.js installed (v18+ recommended).
  • Limitless API Key: You need a valid API Key from Limitless.ai.

Installation

  1. Clone the repository:

    git clone <repository-url>
cd limitless-audio-exporter

  2. Install dependencies:

    npm install

How to Run

This application requires two processes running simultaneously: the Proxy Server (backend) and the React App (frontend).

1. Start the Proxy Server

The proxy server handles API authentication, CORS, and saves files to your disk.

node proxy-server.js

Runs on http://localhost:3001

2. Start the Application

Open a new terminal window and start the frontend interface.

npm run dev

Runs on http://localhost:3000

3. Use the Exporter

  1. Open your browser and go to http://localhost:3000.
  2. Click the Settings icon (gear) and paste your Limitless API Key.
  3. Select your extraction mode:
    • Single Day
    • Range
    • Whole Month
  4. Click Extract & Download.
  5. Watch the logs! The audio files will be saved automatically to the downloads folder inside the project directory.

Project Structure

  • App.tsx: Main frontend logic and UI.
  • proxy-server.js: Express server that bridges the frontend and the Limitless API, handling file system operations.
  • services/limitlessService.ts: Handles API communication with built-in rate limiting and retry logic.
  • downloads/: Default folder where your audio files will be saved.

Security Note

  • API Key: Your API key is stored locally in your browser's localStorage and is never sent to any server other than the official Limitless API (via your local proxy).
  • Git Ignore: The downloads folder and .env files are configured to be ignored by Git to prevent accidental data leaks.

Note: This is an unofficial tool and is not affiliated with Limitless.ai.