Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Player - Media Viewer

Integrated viewing for documents, audio, video, and presentations

Player Interface Screen

Overview

Player enables users to view and interact with various file types without leaving the conversation:

  • Documents: PDF, DOCX, TXT, MD
  • Presentations: PPTX, ODP
  • Audio: MP3, WAV, OGG, M4A
  • Video: MP4, WEBM, OGV
  • Images: PNG, JPG, GIF, SVG, WEBP

Accessing Player

From Chat

When a bot shares a file, click the preview to open in Player:

From Drive

Navigate to Drive tab and click any supported file to open in Player.

Direct URL

Access files directly:

/player/{bot_id}/{file_path}

Controls by File Type

Document Controls

ControlAction
Previous / NextNavigate pages
Zoom in / outAdjust view size
DownloadDownload original
SearchSearch in document
ThumbnailsPage thumbnails

Audio Controls

ControlAction
Play / PauseControl playback
Rewind / ForwardSkip 10 seconds
VolumeVolume slider
LoopLoop toggle
DownloadDownload file

Video Controls

ControlAction
Play / PauseControl playback
SkipSkip backward / forward
VolumeVolume control
FullscreenEnter fullscreen
SpeedPlayback speed
Picture-in-pictureFloating window
DownloadDownload file

Presentation Controls

ControlAction
Previous / NextNavigate slides
FullscreenPresentation mode
OverviewSlide overview
NotesSpeaker notes (if available)
DownloadDownload original

Keyboard Shortcuts

KeyAction
SpacePlay/Pause (audio/video) or Next (slides)
/ Previous / Next
/ Volume up / down
FFullscreen toggle
MMute toggle
EscExit fullscreen / Close player
+ / -Zoom in / out
Home / EndGo to start / end

BASIC Integration

Share Files with Player Preview


Supported Formats

Documents

FormatExtensionNotes
PDF.pdfFull support with text search
Word.docxConverted to viewable format
Text.txtPlain text with syntax highlighting
Markdown.mdRendered with formatting
HTML.htmlSanitized rendering

Presentations

FormatExtensionNotes
PowerPoint.pptxFull slide support
OpenDocument.odpConverted to slides
PDF.pdfTreated as slides

Audio

FormatExtensionNotes
MP3.mp3Universal support
WAV.wavUncompressed audio
OGG.oggOpen format
M4A.m4aAAC audio
FLAC.flacLossless audio

Video

FormatExtensionNotes
MP4.mp4H.264/H.265
WebM.webmVP8/VP9
OGV.ogvTheora

Images

FormatExtensionNotes
PNG.pngLossless with transparency
JPEG.jpg, .jpegCompressed photos
GIF.gifAnimated support
SVG.svgVector graphics
WebP.webpModern format

Configuration

Configure Player behavior in config.csv:

key,value
player-autoplay,false
player-default-volume,80
player-video-quality,auto
player-preload,metadata
player-allow-download,true
player-max-file-size-mb,100

API Access

Get File for Player

GET /api/drive/{bot_id}/files/{file_path}?preview=true

Stream Media

GET /api/drive/{bot_id}/stream/{file_path}

Supports HTTP Range requests for seeking.

Get Thumbnail

GET /api/drive/{bot_id}/thumbnail/{file_path}

Security

  • Files are served through authenticated endpoints
  • User permissions respected for file access
  • Downloads can be disabled per bot
  • Watermarking available for sensitive documents

Performance

  • Lazy loading for large documents
  • Adaptive streaming for video
  • Thumbnail generation for previews
  • Client-side caching for repeat views

Mobile Support

Player is fully responsive:

  • Touch gestures for navigation
  • Pinch-to-zoom for documents
  • Swipe for slides
  • Native fullscreen support

See Also