EmoTagger Music Platform User Manual - CankayaUniversity/ceng-407-408-2024-2025-EmoTagger-A-Community-driven-Emotion-Annotation-Tool GitHub Wiki

EmoTagger Music Platform User Manual

1. Introduction

Emo Tagger is a web-based music platform that allows users to tag music tracks with emotions, contributing to a rich, community-driven database of music-emotion relationships. It enhances the listening experience by combining music playback with emotional analysis, enabling users to reflect on the emotional impact of each song as they listen. The platform offers advanced features such as personalized user profiles, music statistics, and AI-powered emotion analysis, creating an experience that is both engaging and insightful.

2. Getting Started

2.1 User Registration

To use Emo Tagger, create an account:

  • Click on the Register button
  • Fill in required details (Name, Email, Password)
  • Confirm your password and submit
  • You'll be redirected to login upon successful registration

2.2 Logging In

To access your Emo Tagger account:

  • Click the "Log In" button on the homepage
  • Enter your credentials
  • Click "Login" to access your dashboard

3. Core Features

3.1 Navigation Menu

The left sidebar offers quick navigation to main features:

  • Home
  • Listen & Tag
  • My Favorites
  • Create Playlist
  • Listen Mixed
  • Listening History
  • Leaderboard
  • My Profile

3.2 Music Playback

The bottom player allows you to:

  • Play/Pause tracks
  • Skip forward or backward
  • Adjust volume
  • View track progress
  • See currently playing song information

3.3 Music Emotion Analysis

When listening to music:

  • The AI system analyzes emotional content of songs
  • Click the brain icon to view AI Emotion Analysis
  • See emotion distribution across categories (Sad, Happy, Nostalgic, etc.)
  • View the dominant emotion with confidence percentage
  • Compare AI tags with user tags through visual graphs

3.4 Community Tagging

In the Listen & Tag section:

  • Listen to tracks and tag them with emotions
  • View what emotions other users have tagged (Community Tags)
  • Compare your tags with the community consensus

3.5 User Profile

Manage your profile information:

  • View/edit personal details like name
  • Update profile picture
  • See account information
  • Set country
  • Update phone number
  • View your username and email
  • Manage friends

3.6 Music Statistics

The profile shows personalized music statistics:

  • Most listened genres
  • Genre percentages (e.g., Pop 75%)
  • Listening patterns and preferences

3.7 Friends System

Manage your social connections:

  • Add friends using the search bar
  • View online/offline status of friends
  • See friend requests
  • Interact with friends on the platform

3.8 Theme Settings

Customize your experience:

  • Switch between light and dark mode
  • Adjust interface colors and themes
  • Access theme settings through the profile menu

3.9 Add to Favorites

Users can mark songs they love for quick access later:

  • While listening to a track, click the heart icon (♡) near the player to add it to your Favorites.
  • The song will instantly appear in the "My Favorites" section in the navigation menu.
  • You can remove a song from Favorites by clicking the heart icon again (which will now be filled: ♥).
  • Favorites are saved to your account and accessible anytime from any device after login.

3.10 Create Playlist

Users can create and manage their own playlists:

  • Navigate to the "Create Playlist" section from the sidebar.
  • Click "New Playlist", and give it a name (e.g., Workout Vibes, Rainy Moods).
  • Add songs by browsing or searching for tracks and clicking "Add to Playlist" next to each one.
  • Playlists are saved to your profile and can be edited or deleted at any time.
  • You can create multiple playlists based on different emotions, genres, or moods.

3.11 Leaderboard

The leaderboard highlights the most active users in the community:

  • Access the Leaderboard from the left sidebar.
  • View users who have listened to and tagged the most songs.
  • Compare your activity with others in the community.
  • Rankings showcase the top contributors based on interaction volume.
  • The list updates regularly to reflect recent activity.

4. Listen & Mix Features

4.1 Listen Mixed

Access a shuffle-play feature that:

  • Plays tracks randomly from the entire library
  • Offers a diverse listening experience
  • Helps discover new music

4.2 Music Properties Analysis

For each track, view technical details:

  • Tempo
  • Rhythm
  • Energy level (e.g., 70%)
  • Tonality (e.g., "Major")

5. Privacy and Security

User data is protected according to privacy standards. Users have control over their account information and can update or modify their profile at any time through the profile settings.

6. Logging Out

To exit your account safely:

  • Click on "Log Out" in the upper right corner
  • Your session will end and you'll return to the login screen

7. Admin Panel (For Administrators)

Admin users have access to a dedicated panel with management capabilities not available to regular users. Upon logging in as an admin, the following sections are visible in the sidebar:

7.1 Dashboard

View platform-wide statistics such as:

  • Total number of users
  • Total tags submitted
  • Active songs and genres
  • Monitor real-time platform activity and user engagement levels

7.2 User Management

  • View a list of all registered users
  • Edit or deactivate user accounts if needed
  • Monitor user contributions and behavior
  • Search users by name or email for quick access

7.3 Music Management

  • Delete songs
  • View a list of all uploaded songs in the system
  • Search music by title, artist, or genre