YMMUDE Documentation

Introduction

Your YMMUDE Music Library is a personal, cloud-hosted audio collection. Each user has their own private library — nobody else can see or access your tracks. You can populate it two ways:

• Media Sites — search and pull any track directly from supported media sites into your library
• File Upload — upload your own audio files from your device

Access your library at ymmude.com → My Music in the top navigation.

Adding Music from Media Sites

YMMUDE supports adding tracks from popular media sites directly into your library in seconds. The audio is extracted and stored to your account — no app or extra link needed later.

1. Go to My Music in the top navigation
2. Click Add from Media Sites or use the search bar
3. Type a song title, artist name, or paste a media site URL
4. Browse results and click Add to Library on the track you want
5. The track downloads in the background — it appears in your library when ready

Uploading Your Own Tracks

Have audio files on your device? Upload them directly to your library.

1. Go to My Music in the top navigation
2. Click the Upload button
3. Select one or more audio files from your device
4. Files upload and appear in your library immediately

Supported Formats & Limits

Managing Your Library

Your library displays all added and uploaded tracks. From the library view you can:

• ▶️ Play — send a track to the player instantly
• ⬇️ Download — save the audio file to your device
• 🗑️ Delete — remove a track from your library permanently

Your library is private to your account. Only you can see, play, or manage your tracks.

Crates

Crates are personal playlists inside your music library. You can create as many crates as you like and organize your tracks into themed collections — then play directly from any crate in the player.

Creating a Crate

1. Open My Music from the navigation
2. Scroll to the Crates panel
3. Click New Crate and enter a name
4. The crate appears in your list immediately and is ready to fill

Adding Tracks to a Crate

1. In your library, locate the track you want to add
2. Click the Add to Crate button on the track
3. Select the target crate from the dropdown
4. The track is added — a crate can hold as many tracks as you like

Managing Crate Tracks

Click any crate name in the Crates panel to expand it and view its tracks. From the expanded view you can:

• ▶️ Play Crate — load the crate into the player immediately
• 🗑️ Remove track — remove a specific track from this crate (does not delete it from your library)

Getting Started

The DJ Ymmude Player is a personal streaming player built to play tracks directly from your music library. Navigate to My Music → Player to open it.

The player loads automatically on the Player page. Your playback position and settings are preserved between visits.

Playback Controls

Queue & Playback Order

The player queue is automatically built from your music library. Pressing Play on a track in your library loads it into the player and queues the rest of your library to follow.

• Default order — tracks play in the order they appear in your library
• Shuffle — tracks play in a randomized order
• Repeat track — the current track loops indefinitely
• Repeat all — the full library queue loops continuously

Playing from a Crate

Instead of playing your entire library, you can load any crate directly into the player to hear only the tracks in that collection.

How to Play a Crate

1. Go to My Music and expand the Crates panel
2. Click the ▶ Play button next to the crate you want
3. The player switches to that crate — only those tracks will play
4. All playback controls (shuffle, repeat, skip) work normally within the crate

Switching Between Crates and Full Library

Earnings

Every interaction with music on YMMUDE earns you $YMMUDE tokens. Rewards are tracked in real time and distributed to your custodial wallet on Base.

Reward Rules

Viewing Your Earnings History

1. Open My Wallet from the navigation
2. Click the $YMMUDE tab
3. Your full reward history appears — activity type, track name, amount, and status

Reward Status

API Reference

Wall3t exposes a REST API that lets AI agents, bots, and external applications interact with your wallet — check balances, swap tokens, send tokens, and manage API keys.

Authentication

All API requests require an API key. You can create up to 5 API keys, each with configurable permissions.

1. Open My Wallet and go to the API tab
2. Click Generate API Key
3. Enter a label for the key (e.g. my-agent)
4. Select permissions: read, swap, transfer
5. Copy your key — it starts with w3t_

Include your key in every request:

# As a query parameter
?api_key=w3t_your_key_here

# Or as an HTTP header
X-WALL3T-API-KEY: w3t_your_key_here

Base URL

https://ymmude.com/index.php?option=com_ajax&plugin=wall3t&format=raw&action=ACTION

Endpoints

{
  "pending_balance": 191,
  "sent_balance":    0,
  "total_earned":    191,
  "custodial_address": "0xD3...61",
  "tokens": [
    { "symbol": "ETH",    "balance": "0.001234" },
    { "symbol": "USDC",   "balance": "5.00"     },
    { "symbol": "YMMUDE", "balance": "17931147" }
  ],
  "eth_balance":    "0.001234",
  "ymmude_balance": "17931147"
}

# Quote 0.001 ETH to YMMUDE
?action=swapQuote&amount=0.001&from_token=ETH&to_token=YMMUDE&api_key=w3t_...

Example — Check Balance with curl

curl "https://ymmude.com/index.php?option=com_ajax&plugin=wall3t&format=raw&action=getBalance&api_key=w3t_your_key"

Example — Swap ETH for YMMUDE

curl "https://ymmude.com/index.php?option=com_ajax&plugin=wall3t&format=raw&action=swapToken&from_token=ETH&to_token=YMMUDE&amount=0.001&api_key=w3t_your_key"

Base Wallet

Every YMMUDE user automatically gets a custodial wallet on the Base blockchain. This wallet receives your $YMMUDE token rewards and supports a full suite of Base assets.

Wallet UI Tokens

The Wall3t wallet UI supports 9 tokens with live balances, swaps, and sends directly from the browser:

Wallet Tab Features

Swapping Tokens

1. Open My Wallet → Wallet tab
2. Scroll to the Swap panel
3. Choose your From token and enter the amount
4. Choose your To token
5. Click Get Quote to preview the rate
6. Click Swap — the transaction is broadcast on Base

Sending Tokens

1. Open My Wallet → Wallet tab
2. Scroll to the Send panel
3. Select the token you want to send
4. Enter the recipient's Base address (0x...)
5. Enter an amount, or click MAX to use your full balance
6. Click Send to confirm the transfer

Overview

Space Agent is YMMUDE's built-in AI assistant, available 24/7 at space.ymmude.com. It is fully integrated into the YMMUDE ecosystem — it knows your music library, crates, Wall3t wallet, token balances, and earning history, and can interact with all of them on your behalf.

Space Agent is the AI layer of YMMUDE. Use it alongside your music to get platform help, discover tracks, manage your wallet, or ask anything — all in natural language.

How to Use

1. Log in to your YMMUDE account at ymmude.com
2. Navigate to space.ymmude.com — your session carries over automatically
3. The chat interface loads with your YMMUDE context ready
4. Type your question or request in the message box at the bottom
5. Press Enter or click Send
6. Space Agent responds in real time, with full awareness of your account

What Space Agent Can Help With

Tips for Best Results

• Be specific — “How do I earn tokens by listening?” works better than “tokens”
• Space Agent remembers context within a session — follow up naturally
• Reload the page to start a fresh conversation on a new topic