5-Minute Quickstart Guide
Step-by-step walkthrough to set up your profile, create your first workspace, import a YouTube playlist, and log your first study session.
Step 1: Complete Profile Setup (Earn 25 Coins)#
When you first launch Mudawim, click Setup Profile in the top navigation bar or sidebar. Filling in your name, email, phone number, and study intent achieves 100% Profile Completion and automatically credits 25 Streak Coins to your rewards vault.
Pro Tip
Setting your study intent helps Mudawim customize your motivation prompts and dashboard greetings.
Step 2: Create Your First Workspace#
Workspaces allow you to compartmentalize different domains of study (e.g., *Frontend Engineering*, *Machine Learning*, *Arabic Grammar*).
- Navigate to Workspaces from the sidebar.
- Click Create Workspace.
- Choose a title, descriptive summary, icon, and an Accent Color (such as *Emerald*, *Indigo*, *Rose*, *Sky*, *Amber*, or *Purple*).
- Select the workspace to make it your active study domain.
Step 3: Add a YouTube Playlist or Course#
You can add courses in two ways:
Option A: Direct YouTube URL#
- Go to My Courses and click Add Course / Playlist.
- Paste any public YouTube playlist URL or individual video URL (e.g.,
https://www.youtube.com/playlist?list=PL...). - Mudawim automatically fetches video titles, sequence indices, thumbnails, and duration metadata.
Option B: Curated Preset Courses#
- Click Explore in the navigation.
- Browse pre-scraped, high-quality curated tracks across Web Development, Computer Science, AI, and Math.
- Click Add to My Workspace to immediately add the curated track to your active workspace.
Step 4: Watch, Timestamp, and Take Notes#
- Click on any video from your course list to open the Distraction-Free Video Player.
- As you watch:
- Press `Space` to play/pause.
- Press `J` or `L` to jump 10 seconds backward or forward.
- Press `N` at any pivotal moment to instantly capture the current second (e.g. [04:25]) and start typing markdown notes.
- Your progress, watched duration, and notes are saved automatically in real-time.
Step 5: Review Streak & Goal Rings#
Once you finish your session:
- Check your Dashboard Goal Ring to see how your minutes contribute toward your daily target (default 30 mins).
- Check the Streak & Analytics page to see your current consecutive study streak incremented and your 12-week heatmap lit up!