VidPulse

Stop wasting time on clickbait. VidPulse is a mindful video consumption tool that analyzes YouTube videos before you watch, helping you make informed decisions about what deserves your attention.

## How It Works
1. Navigate to any YouTube video
2. VidPulse fetches the video's transcript and analyzes it with AI via OpenRouter
3. View the analysis panel showing summary, scores, and verdict
4. Make informed decisions about what to watch

## Video Analysis Features

### Smart Analysis
- AI-generated video summaries from transcript
- Key points extraction with timestamps
- Chapter breakdowns
- Relevant tags

### Quality Scores
Rate videos across 5 dimensions:
- Productivity - Will this help you get things done?
- Educational - Will you learn something valuable?
- Entertainment - Is it worth watching for fun?
- Inspiring - Will it motivate you?
- Creative - Is the content original and well-crafted?

### Worth It Verdict
Get a clear recommendation: Worth It, Maybe, or Skip - personalized to your preferences.

### Personalized Analysis
- Like or dislike analyzed videos
- VidPulse learns what content you value
- Future analysis becomes more relevant to your interests

### Chat with Video
- Ask questions about the video content
- AI answers based on the video's transcript
- Conversation history saved per video
- No need to watch - just ask what you want to know

## Timeline Markers

Visual markers directly on YouTube's progress bar:
- **Chapter markers** show AI-extracted key sections
- **Note markers** show your personal bookmarks
- Click any marker to jump to that moment
- Hover for title, description, or note content
- Semi-transparent when idle, visible when needed

## Video Overlay

Quick access badge visible on the video itself:
- See verdict at a glance (green/yellow/red)
- Like/dislike without opening sidebar
- Click to expand full scores panel
- Perfect for cinema/theater mode
- Syncs with YouTube's control visibility

## Timestamped Notes

Take notes while watching:
- Add notes at current video timestamp
- Click timestamps to jump back
- Auto-saves as you type
- See notes as markers on timeline
- Export to markdown

## Quality Threshold Guardian
- Set minimum quality thresholds for videos
- Get warnings before watching low-quality content
- Schedule focus periods (e.g., weekdays 9-5)
- Stricter thresholds during scheduled focus time
- Block entertainment during work hours
- Temporary pause when you need a break

## Political Content Analysis
- Detects political content in videos
- Maps your consumption on a 2D political compass
- Track how your media diet shifts over time
- Optional - disable if you prefer

## Blind Spot Detection
- Alerts when consuming narrow range of perspectives
- Shows which viewpoints you're missing on topics
- Coverage indicator for perspective diversity
- Helps avoid echo chambers

## Check-in Prompts
- Periodic "Still intentional?" reminders during long sessions
- Shows session summary: watch time, videos by category
- Configurable interval (15-60 minutes)
- Option to take break or continue

## GDPR Data Controls
- Export all your data as JSON
- Granular deletion: remove history while keeping preferences
- Complete account reset option
- API keys stored locally, never synced

## Watch Quality Awareness
- Session timer tracks actual watch time
- Time filters: Today, Week, Month, Year, Custom
- Category charts and visualizations
- Daily/weekly digests and channel analytics
- Make more intentional watching decisions

## Channel Insights
- Track quality scores across channels
- See which channels you've liked videos from
- Identify your most valuable content sources

## Related Content
- Find tutorials, articles, and guides related to the video
- Powered by Brave Search (optional, requires API key)

## Feature Toggles
- Disable expensive features to save API costs
- Toggle: chapters, related content, political analysis
- Control which analysis steps run per video

## Privacy First
- Your API keys stay on your device (never synced)
- No tracking or analytics
- No data sold to third parties
- Open source and auditable

## Requirements
- OpenRouter API key (get one at openrouter.ai/keys)
- Optional: Brave Search API key for related content