What are Playlists?
A playlist is a curated collection of:- Shots or Assets (not mixed)
- Specific preview versions for each item
- Organized order for review flow
- Annotations and feedback on each preview
- Team dailies and reviews
- Client presentations
- Director/supervisor feedback sessions
- Milestone showcases
- Department-specific reviews
The Playlists Page
The playlists page (~/workspace/source/src/components/pages/Playlist.vue:1) has two main areas:Playlist List (Left Sidebar)
Shows all playlists for the current production:- Thumbnail from first item
- Playlist name
- Last updated date
- Task type filter (if applicable)
- Color-coded by task type
- Updated At: Most recently modified first
- Created At: Newest playlists first
- Name: Alphabetically
Playlist Player (Main Area)
Displays the selected playlist:- Preview player with playback controls
- Entity filmstrip showing all items
- Navigation and organization tools
- Add/remove entity controls
Creating Playlists
Only Managers and Supervisors can create playlists.
New Playlist
To create a playlist:- Click New Playlist button
-
Fill in details:
- Name: Descriptive title (e.g., “Week 12 Animation Dailies”)
- Entity Type: Asset or Shot
- Task Type (optional): Filter to specific department
- For Client: Make it client-visible
- For All: Available across all episodes (TV shows)
- Click Confirm
Auto-Generated Playlists
Quickly build playlists with smart filters: Build Daily (Today’s submissions):- Finds shots/assets with previews uploaded today
- For the selected task type (if set)
- Adds in sorted order
- Includes all pending reviews from the week
- Useful for end-of-week reviews
- Adds all shots from current episode
- In sequence/shot order
- Adds all shots in the production
- Useful for full movie reviews
- Click the button next to a sequence name
- Adds all shots from that sequence
Adding Items to Playlists
Manual Selection
With a playlist open:- Click Show Add Entities
- The entity list appears below
- Click any shot/asset to add it
- Already-added items show with purple border
- Scroll to load more items
Search and Filter
Find specific items to add:Drag and Drop
Drag entities from the add list into the filmstrip:- Drag an entity thumbnail
- Drop between existing items
- Or drop at the end to append
Sequence/Bulk Add
For shots, click Add Sequence next to sequence names to add all shots in that sequence at once.Organizing Playlists
Reorder Items
Change the review order:- Drag items in the filmstrip
- Drop where you want them
- Order saves automatically
Remove Items
Remove items you don’t need:- Hover over item in filmstrip
- Click the X button
- Confirm removal
Change Preview Version
Select which version to show:- Click item in filmstrip
- Preview loads in player
- Use version dropdown to select different preview
- Playlist updates to show selected version
Playlist Player Features
Video Playback
For video previews:- Play/Pause: Spacebar or click button
- Seek: Drag timeline scrubber
- Frame Step: Arrow keys
- Speed: Playback speed control
- Loop: Repeat current preview
Navigation
- Filmstrip: Click any item to jump to it
- Previous/Next: Arrow buttons or keyboard
- Auto-advance: Automatically play next item
Full Screen
Click the fullscreen button for distraction-free viewing.Annotations
Draw on previews during review:- Select drawing tool (pencil, rectangle, arrow, text)
- Draw on the preview
- Annotations save to the preview file
- Visible to everyone viewing this preview
Playlist Types
By Entity Type
Shot Playlists:- Review cut/sequence flow
- Check continuity
- Show progress to director/client
- Character lineup reviews
- Prop approvals
- Environment showcases
- Review entire sequences
- Check edit flow
By Task Type
Filter playlists to specific departments:- Animation Dailies: Only animation tasks
- Lighting Review: Only lighting tasks
- Comp Review: Only compositing
Client Playlists
Mark playlists as For Client:- Different visual style (purple)
- Can be shared externally
- Client users can view and comment
- Typically final/approved work only
Playlist Settings
Edit Playlist
Click the settings icon to change:- Playlist name
- Entity type (can’t change once items added)
- Task type filter
- Client visibility
- For All setting (TV shows)
Delete Playlist
Click delete to remove permanently.Build Jobs
For very large playlists, Kitsu can generate downloadable video files:Create Build
- Click Build in playlist settings
-
Choose options:
- Full build: Concatenate all previews
- Individual files: Separate video per item
- Job starts in background
- Download link appears when ready
Build Status
Build jobs show:- Running: Processing
- Done: Ready to download
- Failed: Error occurred
Review Workflows
Daily Reviews
- Create playlist: “Daily - [Date]”
- Use Build Daily to auto-populate
- Reorder by priority
- Present in team meeting
- Add verbal feedback as annotations/comments
- Artists address feedback
Client Reviews
- Create For Client playlist
- Add only approved shots
- Order narratively (story order)
- Annotate key points for client
- Share playlist link
- Collect client feedback in comments
Supervisor Reviews
- Create task-type specific playlist (e.g., “Animation - Week 12”)
- Add all WFA (Waiting for Approval) items
- Review systematically
- Annotate issues directly
- Update task statuses (Approved/Retake)
- Export annotations for artists
Sharing Playlists
Share playlists for review:Internal Sharing
All team members can access playlists for their production. Simply share the URL.External Sharing
For clients or stakeholders:- Mark playlist as For Client
- Share the playlist URL
- Client users (with accounts) can:
- View all previews
- Add comments
- Draw annotations
- See task info
Playlist Sorting
Sort playlists in the list:- Updated At: Most recent activity first
- Created At: Newest playlists
- Name: Alphabetically
Task Type Filtering
Filter the playlist list:- Select task type from dropdown
- Only shows playlists for that task type
- Or “All” to show everything
Best Practices
Naming Playlists
Use clear, descriptive names:- Include date: “2024-03-15 Animation Dailies”
- Include department: “Lighting Review - Week 12”
- Include purpose: “Client Review - Milestone 3”
- TV shows: “Ep05 - Layout Review”
Organization
- Create playlists regularly (daily/weekly)
- Delete old playlists after review
- Keep client playlists separate
- Archive important milestone playlists
Review Process
- Review in story order when possible
- Address critical issues first
- Take notes during review
- Follow up after with task updates
- Communicate feedback clearly
Performance
- Large playlists (100+ items) may load slowly
- Consider splitting into smaller playlists
- Use build jobs for very large reviews
- Close unused playlists
Annotations
- Use different colors for different note types
- Combine with text comments for clarity
- Be specific with placement
- Extract snapshots for archival
Keyboard Shortcuts
- Space: Play/pause
- Left/Right Arrows: Previous/next item
- Up/Down Arrows: Frame-by-frame (video)
- F: Fullscreen
- Escape: Exit fullscreen
Related Features
Tasks
Update task status from reviews
Shots
Build shot playlists
Assets
Build asset playlists
