[{"data":1,"prerenderedAt":701},["ShallowReactive",2],{"content-en-\u002Fguide\u002Ftroubleshooting":3},{"id":4,"title":5,"author":6,"body":7,"date":6,"description":694,"extension":695,"meta":696,"navigation":139,"path":697,"seo":698,"stem":699,"tags":6,"__hash__":700},"content_en\u002Fguide\u002Ftroubleshooting.md","Troubleshooting",null,{"type":8,"value":9,"toc":668},"minimark",[10,14,19,24,46,50,69,73,77,88,92,96,101,162,167,185,189,213,217,253,257,261,339,343,410,414,451,455,459,470,474,490,494,498,501,534,540,544,547,634,638,664],[11,12,5],"h1",{"id":13},"troubleshooting",[15,16,18],"h2",{"id":17},"connection-issues","Connection Issues",[20,21,23],"h3",{"id":22},"connection-failed-networkerror","\"Connection failed: NetworkError\"",[25,26,27,35],"ul",{},[28,29,30,34],"li",{},[31,32,33],"strong",{},"PWA",": Verify the CMS address matches the domain the player is served from (same-origin requirement). Use Electron or Chromium for cross-origin setups.",[28,36,37,40,41,45],{},[31,38,39],{},"Electron\u002FChromium",": Check that the CMS is reachable from the player. Try ",[42,43,44],"code",{},"curl https:\u002F\u002Fyour-cms.example.com\u002Fxmds.php"," from the player machine.",[20,47,49],{"id":48},"display-not-authorized","\"Display not authorized\"",[51,52,53,56,59,62],"ol",{},[28,54,55],{},"Go to CMS → Displays",[28,57,58],{},"Find your display (status: Waiting)",[28,60,61],{},"Click Authorize",[28,63,64,65,68],{},"Wait up to 30 seconds or press ",[42,66,67],{},"D"," in the player to force a collection",[20,70,72],{"id":71},"player-shows-offline-badge","Player shows \"OFFLINE\" badge",[74,75,76],"p",{},"The player has lost CMS connectivity but is still showing cached content. Check:",[25,78,79,82,85],{},[28,80,81],{},"Network connection on the player machine",[28,83,84],{},"CMS availability",[28,86,87],{},"Firewall rules (port 443 for HTTPS, port 9505 for XMR WebSocket)",[15,89,91],{"id":90},"display-issues","Display Issues",[20,93,95],{"id":94},"black-screen","Black screen",[74,97,98],{},[31,99,100],{},"Electron:",[102,103,108],"pre",{"className":104,"code":105,"language":106,"meta":107,"style":107},"language-bash shiki shiki-themes material-theme-lighter github-light github-dark","# Check PWA files exist\nls -la ~\u002F.local\u002Fshare\u002Fxiboplayer\u002Felectron\u002Fpwa\u002F\n\n# Reinstall if missing\nsudo dnf reinstall xiboplayer-electron\n","bash","",[42,109,110,119,134,141,147],{"__ignoreMap":107},[111,112,115],"span",{"class":113,"line":114},"line",1,[111,116,118],{"class":117},"sutJx","# Check PWA files exist\n",[111,120,122,126,130],{"class":113,"line":121},2,[111,123,125],{"class":124},"sbgvK","ls",[111,127,129],{"class":128},"stzsN"," -la",[111,131,133],{"class":132},"s_sjI"," ~\u002F.local\u002Fshare\u002Fxiboplayer\u002Felectron\u002Fpwa\u002F\n",[111,135,137],{"class":113,"line":136},3,[111,138,140],{"emptyLinePlaceholder":139},true,"\n",[111,142,144],{"class":113,"line":143},4,[111,145,146],{"class":117},"# Reinstall if missing\n",[111,148,150,153,156,159],{"class":113,"line":149},5,[111,151,152],{"class":124},"sudo",[111,154,155],{"class":132}," dnf",[111,157,158],{"class":132}," reinstall",[111,160,161],{"class":132}," xiboplayer-electron\n",[74,163,164],{},[31,165,166],{},"Chromium:",[102,168,170],{"className":104,"code":169,"language":106,"meta":107,"style":107},"# Check if the server is running\ncurl http:\u002F\u002Flocalhost:8765\u002Fplayer\u002Fpwa\u002F\n",[42,171,172,177],{"__ignoreMap":107},[111,173,174],{"class":113,"line":114},[111,175,176],{"class":117},"# Check if the server is running\n",[111,178,179,182],{"class":113,"line":121},[111,180,181],{"class":124},"curl",[111,183,184],{"class":132}," http:\u002F\u002Flocalhost:8765\u002Fplayer\u002Fpwa\u002F\n",[20,186,188],{"id":187},"layouts-dont-show","Layouts don't show",[25,190,191,198,201,208],{},[28,192,193,194,197],{},"Check browser console (Electron: ",[42,195,196],{},"Ctrl+Shift+I"," in dev mode) for download errors",[28,199,200],{},"Verify schedule has active layouts assigned to this display in CMS",[28,202,203,204,207],{},"Press ",[42,205,206],{},"T"," to check the timeline — if empty, the schedule hasn't been received yet",[28,209,203,210,212],{},[42,211,67],{}," to check if media is still downloading",[20,214,216],{"id":215},"video-wont-play","Video won't play",[25,218,219,243,250],{},[28,220,221,222],{},"Install VAAPI drivers for hardware video decode:\n",[25,223,224,230,236],{},[28,225,226,227],{},"Intel: ",[42,228,229],{},"sudo dnf install libva-intel-media-driver",[28,231,232,233],{},"AMD: ",[42,234,235],{},"sudo dnf install mesa-va-drivers",[28,237,238,239,242],{},"NVIDIA: ",[42,240,241],{},"sudo dnf install libva-nvidia-driver"," (from RPM Fusion)",[28,244,245,246,249],{},"Check ",[42,247,248],{},"vainfo"," to verify hardware decode is working",[28,251,252],{},"HLS streams require network access — they cannot be cached offline",[15,254,256],{"id":255},"service-issues","Service Issues",[20,258,260],{"id":259},"player-wont-start","Player won't start",[102,262,264],{"className":104,"code":263,"language":106,"meta":107,"style":107},"# Check if port 8765 is in use\nss -tlnp | grep 8765\n\n# Try a different port\nxiboplayer-electron --port=8080\n\n# Check service logs\njournalctl --user -u xiboplayer-electron.service -n 50\n",[42,265,266,271,290,294,299,307,312,318],{"__ignoreMap":107},[111,267,268],{"class":113,"line":114},[111,269,270],{"class":117},"# Check if port 8765 is in use\n",[111,272,273,276,279,283,286],{"class":113,"line":121},[111,274,275],{"class":124},"ss",[111,277,278],{"class":128}," -tlnp",[111,280,282],{"class":281},"smGrS"," |",[111,284,285],{"class":124}," grep",[111,287,289],{"class":288},"srdBf"," 8765\n",[111,291,292],{"class":113,"line":136},[111,293,140],{"emptyLinePlaceholder":139},[111,295,296],{"class":113,"line":143},[111,297,298],{"class":117},"# Try a different port\n",[111,300,301,304],{"class":113,"line":149},[111,302,303],{"class":124},"xiboplayer-electron",[111,305,306],{"class":128}," --port=8080\n",[111,308,310],{"class":113,"line":309},6,[111,311,140],{"emptyLinePlaceholder":139},[111,313,315],{"class":113,"line":314},7,[111,316,317],{"class":117},"# Check service logs\n",[111,319,321,324,327,330,333,336],{"class":113,"line":320},8,[111,322,323],{"class":124},"journalctl",[111,325,326],{"class":128}," --user",[111,328,329],{"class":128}," -u",[111,331,332],{"class":132}," xiboplayer-electron.service",[111,334,335],{"class":128}," -n",[111,337,338],{"class":288}," 50\n",[20,340,342],{"id":341},"service-wont-auto-start","Service won't auto-start",[102,344,346],{"className":104,"code":345,"language":106,"meta":107,"style":107},"# Enable lingering (allows user service without login)\nloginctl enable-linger $USER\n\n# Re-enable the service\nsystemctl --user enable --now xiboplayer-electron.service\n\n# Check status\nsystemctl --user status xiboplayer-electron.service\n",[42,347,348,353,365,369,374,390,394,399],{"__ignoreMap":107},[111,349,350],{"class":113,"line":114},[111,351,352],{"class":117},"# Enable lingering (allows user service without login)\n",[111,354,355,358,361],{"class":113,"line":121},[111,356,357],{"class":124},"loginctl",[111,359,360],{"class":132}," enable-linger",[111,362,364],{"class":363},"su5hD"," $USER\n",[111,366,367],{"class":113,"line":136},[111,368,140],{"emptyLinePlaceholder":139},[111,370,371],{"class":113,"line":143},[111,372,373],{"class":117},"# Re-enable the service\n",[111,375,376,379,381,384,387],{"class":113,"line":149},[111,377,378],{"class":124},"systemctl",[111,380,326],{"class":128},[111,382,383],{"class":132}," enable",[111,385,386],{"class":128}," --now",[111,388,389],{"class":132}," xiboplayer-electron.service\n",[111,391,392],{"class":113,"line":309},[111,393,140],{"emptyLinePlaceholder":139},[111,395,396],{"class":113,"line":314},[111,397,398],{"class":117},"# Check status\n",[111,400,401,403,405,408],{"class":113,"line":320},[111,402,378],{"class":124},[111,404,326],{"class":128},[111,406,407],{"class":132}," status",[111,409,389],{"class":132},[20,411,413],{"id":412},"cant-exit-kiosk-mode","Can't exit kiosk mode",[25,415,416,426,438],{},[28,417,418,421,422,425],{},[31,419,420],{},"Electron",": Press ",[42,423,424],{},"Ctrl+Shift+F12"," for the system tray menu → Exit Player",[28,427,428,421,431,434,435],{},[31,429,430],{},"Kiosk",[42,432,433],{},"Ctrl+R"," (keyd shortcut) to reconfigure, or SSH in and run ",[42,436,437],{},"pkill xiboplayer",[28,439,440,443,444,447,448],{},[31,441,442],{},"From terminal",": ",[42,445,446],{},"pkill -f xiboplayer-electron"," or ",[42,449,450],{},"pkill -f chromium",[15,452,454],{"id":453},"performance-issues","Performance Issues",[20,456,458],{"id":457},"high-memory-usage","High memory usage",[25,460,461,464,467],{},[28,462,463],{},"Check if the content includes very large images or videos",[28,465,466],{},"The player caps downloads based on device RAM — low-memory devices (\u003C 4GB) use smaller chunks",[28,468,469],{},"If memory keeps growing, check for layouts with many concurrent video elements",[20,471,473],{"id":472},"slow-media-downloads","Slow media downloads",[25,475,476,481,484,487],{},[28,477,203,478,480],{},[42,479,67],{}," to see download progress and speed",[28,482,483],{},"Check network bandwidth to the CMS",[28,485,486],{},"The player uses 4 parallel download chunks — ensure the CMS\u002Freverse proxy allows concurrent connections",[28,488,489],{},"Check if a download window is configured in CMS display settings that might be blocking downloads",[15,491,493],{"id":492},"kiosk-specific-issues","Kiosk-Specific Issues",[20,495,497],{"id":496},"setup-wizard-doesnt-appear","Setup wizard doesn't appear",[74,499,500],{},"The wizard runs only on first boot when no CMS config exists. To re-trigger:",[102,502,504],{"className":104,"code":503,"language":106,"meta":107,"style":107},"# Remove existing config and restart\nrm -f ~\u002F.config\u002Fxiboplayer\u002Fconfig.json\nsystemctl --user restart xibo-player.service\n",[42,505,506,511,522],{"__ignoreMap":107},[111,507,508],{"class":113,"line":114},[111,509,510],{"class":117},"# Remove existing config and restart\n",[111,512,513,516,519],{"class":113,"line":121},[111,514,515],{"class":124},"rm",[111,517,518],{"class":128}," -f",[111,520,521],{"class":132}," ~\u002F.config\u002Fxiboplayer\u002Fconfig.json\n",[111,523,524,526,528,531],{"class":113,"line":136},[111,525,378],{"class":124},[111,527,326],{"class":128},[111,529,530],{"class":132}," restart",[111,532,533],{"class":132}," xibo-player.service\n",[74,535,536,537,539],{},"Or press ",[42,538,433],{}," (keyd shortcut) to reconfigure.",[20,541,543],{"id":542},"screen-blanks-goes-to-sleep","Screen blanks \u002F goes to sleep",[74,545,546],{},"The kiosk disables screen blanking via gsettings and logind, but if it still happens:",[102,548,550],{"className":104,"code":549,"language":106,"meta":107,"style":107},"# Verify settings\ngsettings get org.gnome.desktop.session idle-delay\n# Should be 0\n\n# Check logind\nloginctl show-session $(loginctl | grep xibo | awk '{print $1}') -p IdleAction\n# Should be ignore\n",[42,551,552,557,571,576,580,585,629],{"__ignoreMap":107},[111,553,554],{"class":113,"line":114},[111,555,556],{"class":117},"# Verify settings\n",[111,558,559,562,565,568],{"class":113,"line":121},[111,560,561],{"class":124},"gsettings",[111,563,564],{"class":132}," get",[111,566,567],{"class":132}," org.gnome.desktop.session",[111,569,570],{"class":132}," idle-delay\n",[111,572,573],{"class":113,"line":136},[111,574,575],{"class":117},"# Should be 0\n",[111,577,578],{"class":113,"line":143},[111,579,140],{"emptyLinePlaceholder":139},[111,581,582],{"class":113,"line":149},[111,583,584],{"class":117},"# Check logind\n",[111,586,587,589,592,596,598,600,602,605,607,610,614,617,620,623,626],{"class":113,"line":309},[111,588,357],{"class":124},[111,590,591],{"class":132}," show-session",[111,593,595],{"class":594},"sP7_E"," $(",[111,597,357],{"class":124},[111,599,282],{"class":281},[111,601,285],{"class":124},[111,603,604],{"class":132}," xibo",[111,606,282],{"class":281},[111,608,609],{"class":124}," awk",[111,611,613],{"class":612},"sjJ54"," '",[111,615,616],{"class":132},"{print $1}",[111,618,619],{"class":612},"'",[111,621,622],{"class":594},")",[111,624,625],{"class":128}," -p",[111,627,628],{"class":132}," IdleAction\n",[111,630,631],{"class":113,"line":314},[111,632,633],{"class":117},"# Should be ignore\n",[15,635,637],{"id":636},"getting-help","Getting Help",[25,639,640,651,657],{},[28,641,642,643,650],{},"Check the ",[644,645,649],"a",{"href":646,"rel":647},"https:\u002F\u002Fgithub.com\u002Fxibo-players",[648],"nofollow","GitHub issues"," for your specific player",[28,652,653,654],{},"Include logs when reporting issues: ",[42,655,656],{},"journalctl --user -u xiboplayer-electron.service --no-pager -n 100",[28,658,659,660,663],{},"For Electron, include the browser console output (enable with ",[42,661,662],{},"--dev"," flag)",[665,666,667],"style",{},"html pre.shiki code .sutJx, html code.shiki .sutJx{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#6A737D;--shiki-dark-font-style:inherit}html pre.shiki code .sbgvK, html code.shiki .sbgvK{--shiki-light:#E2931D;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .stzsN, html code.shiki .stzsN{--shiki-light:#91B859;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .smGrS, html code.shiki .smGrS{--shiki-light:#39ADB5;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .su5hD, html code.shiki .su5hD{--shiki-light:#90A4AE;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":107,"searchDepth":136,"depth":136,"links":669},[670,675,680,685,689,693],{"id":17,"depth":121,"text":18,"children":671},[672,673,674],{"id":22,"depth":136,"text":23},{"id":48,"depth":136,"text":49},{"id":71,"depth":136,"text":72},{"id":90,"depth":121,"text":91,"children":676},[677,678,679],{"id":94,"depth":136,"text":95},{"id":187,"depth":136,"text":188},{"id":215,"depth":136,"text":216},{"id":255,"depth":121,"text":256,"children":681},[682,683,684],{"id":259,"depth":136,"text":260},{"id":341,"depth":136,"text":342},{"id":412,"depth":136,"text":413},{"id":453,"depth":121,"text":454,"children":686},[687,688],{"id":457,"depth":136,"text":458},{"id":472,"depth":136,"text":473},{"id":492,"depth":121,"text":493,"children":690},[691,692],{"id":496,"depth":136,"text":497},{"id":542,"depth":136,"text":543},{"id":636,"depth":121,"text":637},"Common issues and solutions for XiboPlayer.","md",{},"\u002Fguide\u002Ftroubleshooting",{"title":5,"description":694},"guide\u002Ftroubleshooting","rANH_g0InETwGJUIauKe5DFX2mwbPg0XnOcKqwYPr0U",1775148105253]