Help Center

1. Connect Apple Music or Spotify in Settings
2. Describe your mood using voice or text, OR adjust the mood dial
3. Tap Play to start discovering music

Three ways to set your mood:

• Voice: Tap mic and speak your feelings
• Text: Tap keyboard and type your mood
• Dial: Rotate to adjust Emotion or Energy

MeloTune remembers your settings between sessions.

Two meters capture your mood:

EMOTION (0-99): How you feel

• 0-30: Sad, melancholic
• 31-60: Neutral, contemplative
• 61-99: Happy, euphoric

ENERGY (0-99): Your intensity level

• 0-30: Calm, relaxed
• 31-60: Moderate
• 61-99: Active, intense

Adjust using the dial, meters, or voice input.

• Apple Music: Requires subscription
• Spotify: Requires Premium subscription
• Local Music: Your own imported music files (no subscription needed)

Connect in Settings. Switch between services anytime.

1. Open Settings (tap Settings in bottom nav)
2. Find 'MUSIC SERVICE' section
3. Tap Apple Music, Spotify, or Local Music
4. Tap 'CONNECT' if not connected

The checkmarked service is active. Switching refreshes your playlist.

1. Go to Settings → Favorites → Import → Local Music to add your music folders
2. Select Local Music as your primary service

Supported formats: MP3, M4A, WAV, FLAC, AIFF

Local music works offline and gets mood-analyzed automatically.

1. Go to Settings > PLAYBACK DEVICE
2. Tap a device to play there
3. Use 'REFRESH DEVICES' if needed

Tip: If device doesn't appear, open Spotify app, play any song briefly, then refresh.

No. Spotify Premium is required to use MeloTune with Spotify.

Tap the mic button and speak naturally:

• "Happy and energetic"
• "Relaxed evening vibes"
• "Workout music"

MeloTune finds matching music instantly.

Tap the keyboard button and type your mood:

• "Chill morning"
• "Intense focus"
• "Sad but hopeful"

MeloTune maps your words to the perfect mood.

• Play/Pause: Tap center button
• Skip: Swipe album left or tap next
• Previous: Swipe album right or tap prev
• Similar songs: Long-press play button

Tap album card to flip, then tap the heart icon.

Access favorites via Favorites in bottom navigation.

1. Tap album card to flip
2. Tap playlist icon (right side)
3. Select or create a playlist

Access playlists via Playlists in bottom navigation.

Four display modes available via header buttons:

• DIAL: Vinyl-style rotating dial for mood adjustment. Tap center to switch Emotion/Energy.
• METERS: Ferrari-style gauges with filter knobs. Drag gauges to adjust mood.
• FOCUS: Clock display with Focus/Study Mode timer. Perfect for productivity sessions.
• TRACKS: Album card with playlist. View and tap songs directly.

Rotate the dial to adjust your mood:

• Clockwise: Increase value
• Counter-clockwise: Decrease value

Tap center to switch between Emotion and Energy modes. The vinyl spins while music plays.

Drag on either gauge to adjust:

• EMOTION gauge: Sad to Happy (0-99)
• ENERGY gauge: Calm to Hyper (0-99)

Four filter knobs below control:

• MATCH: Mood matching precision
• FAME: Popular hits vs deep cuts
• ERA: Retro, any, or new music
• VOCAL: Instrumental vs vocal

IND: Industry genres (Rock, Jazz, EDM, etc.) - you pick manually.

400: MeloTune mood genres - auto-updates based on your Emotion and Energy.

Genre Panel (in Dashboard):

• Tap left/right arrows to browse genres
• Swipe the genre display left/right
• Tap genre display to open picker

Tap IND or 400 button to open that genre picker directly.

Four knobs fine-tune your music discovery:

MATCH: Mood precision (Strict / Mod / Loose)

FAME: Popularity (Deep cuts / Mix / Hits)

ERA: Release period (Retro / Any / New)

VOCAL: Vocals preference (Instrumental / Any / Vocal)

Drag each knob to rotate between three positions. Haptic feedback confirms your selection. Settings save automatically.

Stations are saved mood presets. Each captures your Emotion, Energy, and genre settings.

Tap any station to instantly load that mood and start playing.

1. Set your mood using dial, meters, or voice
2. Scroll to Stations panel
3. Tap '+ ADD STATION'
4. Name it and tap Create

• Tap: Play the station
• Long-press: Rename or delete

The playing station shows a glowing ring and appears as a badge.

Tap the 'INSIGHTS' handle on the right side (opposite the GENRE handle).

The panel shows:

• MoodLock toggle
• Valence, Stability, and Energy gauges
• 'Show Insights' button for detailed cards

Tap 'Show Insights' to reveal:

• Emotional Insight: Current mood vocabulary term, definition, and what music is doing for you
• Today's Mood Summary: Daily vocabulary, headline, stats
• Your Weekly Story: Theme, key vocabulary, narrative journey
• Listening Journey: Total listening time, sessions, emerging patterns

Focus Mode provides Pomodoro-style work sessions with optimized music.

Four modes available:

• STUDY: Lo-Fi beats for long work sessions
• THINK: Ambient sounds for deep thinking
• CREATE: Instrumental music for creative work
• FLOW: Electronic beats for energetic productivity

Each mode auto-curates music matched to that mental state.

Two ways:

1. Tap 'Focus' in bottom navigation bar
2. Use voice commands: "Study for 30 minutes", "Deep work", "Pomodoro"

Music starts automatically with the timer.

• Pomodoro: 25 min focus, 5 min break
• Extended: 50 min focus, 10 min break
• Sprint: 15 min focus, 3 min break
• Deep Work: 90 min focus, 20 min break

Or set any custom duration via voice.

Tap the moon icon or use voice:

• "Sleep timer 30 minutes"
• "Stop playing in 1 hour"

Presets: 15, 30, 45 minutes or 1, 1.5, 2 hours.

Music fades out and stops when timer ends.

Ready For You is MeloTune's intelligent playlist prediction feature. It learns your listening patterns and pre-curates music before you even ask.

When you open MeloTune, a personalized playlist is already waiting — perfectly matched to your current mood, time of day, and listening history.

1. Listen to music regularly (builds your mood profile)
2. Open MeloTune when you want music
3. Look for the 'Ready For You' card on the home screen
4. Tap 'Play Now' to start instantly

If you want something different, tap 'Choose Different' to use the mood dial instead.

MeloTune learns from your choices:

• Playing the suggestion = positive signal
• Skipping tracks = adjusts future predictions
• Choosing different mood = learns your preference

Every interaction improves future predictions.

Mood Portrait creates AI-generated art that visualizes your emotional state based on your listening patterns.

Each portrait is a unique cinematic scene that captures:

• Your dominant mood blend (e.g., Calm 52%, Energized 26%)
• A poetic label describing your emotional state
• Time-of-day atmosphere

Perfect for sharing on social media or saving as a personal keepsake.

Mood Portrait uses DALL-E 3 to generate images. You'll need your own OpenAI API key:

1. Go to Settings → OpenAI
2. Enter your API key from platform.openai.com
3. Tap Save

Your key is stored securely on-device. Each portrait costs approximately $0.12 via your OpenAI account.

1. Play music for 2-3 minutes (to build mood data)
2. Tap the Insights button (right of voice input)
3. Tap 'Show Insights'
4. Tap 'Create My Portrait'
5. Wait 30-60 seconds for DALL-E generation

Tip: The longer you listen, the more accurate your mood blend becomes.

After generation completes:

• Share: Tap the Share button to save to Photos or share via Messages
• Regenerate: Tap 'New Scene' to create a different visualization of the same mood

Each portrait includes your mood blend and poetic label as a shareable story card.