How to submit a useful support request


Sometimes things can go wrong. By collating and submitting a detailed bug report OSMC developers and the wider community can resolve the issue more quickly.

Where should you report these issues?

Unless it has been ascertained that the issue a confirmed bug in OSMC itself, GitHub should be avoided. We ask kindly that users initially use our support forum until it is indeed verified that the issue is caused by a bug in OSMC.

Please clearly explain the problem

In your report, please let us know:

  • The issue you are currently experiencing with OSMC
  • What you were doing when this issue occurred
  • Whether you can replicate this issue on demand. If you can, then please provide some steps on how an OSMC developer can reproduce the same issue.
  • The device you are currently running OSMC on
  • What peripherals are attached to the device?
  • Has this issue been introduced by a new version of OSMC? When did the issue first appear and can you recall a time when it was not present?

Providing diagnostic logs

Logs are needed so we can identify problems quickly. A full set of logs should be uploaded with ease via My OSMC.

Before uploading any logs, you should ensure that Debugging is enabled in Kodi. This can be done by going to Settings → System → Logging → and selecting Enable Debugging. You should then perform a reboot of your device and perform only the minimum actions required to replicate this issue so that it is easy to identify the cause of the problem.

If you are using the default OSMC skin, then My OSMC will be accessible via your Home screen. If you are using Confluence then it will be available via the Settings sub-menu. For other skins, My OSMC can be found via the Programs section. Before doing so, you should read the rest of this article.

After opening My OSMC, navigate to Logs. Using this method will result in a URL link that you should provide so that others may be able to view.

Kodi related issues

Did you know?: Some add-ons can cause problems with Kodi and OSMC. Did you install an addon recently before experiencing a Kodi issue? Try disabling it via Settings → Add-ons and seeing if the issue goes away. If it does, you should contact the add-on developer for support.

Playback related issues: using MediaInfo

Video and audio comes in a variety of formats. MediaInfo is an application which displays information about the encoded format, the container and other technical elements.

We can use this to see identify problematic files as well as identify issues with playback.

To obtain and upload MediaInfo output:

  1. Download and install MediaInfo
  2. Run MediaInfo and use it to ‘Open’ the file you want to inspect.
  3. Switch view from MediaInfo menu, select ‘View’ then from the drop down list select ‘Text’.
  4. You can select the text in MediaInfo and then copy and paste this output to
  5. Provide the generated link in your forum post and give us much information about the problem as possible.

When you can’t upload logs via My OSMC

If Kodi is not loading, or you are experiencing an issue with My OSMC, you may find yourself unable to upload logs from your remote. Logs can also be uploaded via the command line and result in a URL you can provide for support by running the following command:

grab-logs -A

Sanitizing your logs

While generally the script tries to hide all passwords we know that certain people still are not comfortable with any information shared. If you are one of those first create the file locally, edit it and then upload it. To do so use:

grab-logs -A -C
nano /boot/uploadlog.txt
paste-log /boot/uploadlog.txt

If you upload a such altered log file please let us know so that we don’t wonder about possible gaps.

Help us help you:

  • Please use the official OSMC pastebin
  • Please do not upload logs as free text in forum posts
  • Don’t trim any logs, doing so may hide the problem.

Submitting Kodi Screenshots

By posting a Kodi screenshot in your support question, it may help diagnose the problem.

You can take screenshots of Kodi when it’s running, by running the following command via ssh/command line:

kodi-send --action=TakeScreenshot

You can chose where you want to save screenshots in the System->Settings-Debug->Screenshot Folder.

If you don’t define a screenshot folder before taking a screenshot, a file browser window will appear on the Kodi display, so you can choose one.

The best location to save the screenshots, is a networked drive where you can access the file.
If you save the screenshots on the osmc device, you could transfer the screenshots to your Desktop, with ssh/scp.

The files are named screenshot###.png

Update failing (unknown package)
About the Raspberry Pi category
About the Apple TV category
About the Vero category
Kodi only plaus first video
Vero 4K, Video short blackouts
SMB Share no more working after recent upgrade of windows
Cannot connect to files on FTP server
Various Problems with RasPi 3
Full-bluray choppy video playback on last OSMC version
Full-bluray choppy video playback on last OSMC version
Unable to watch movies from my NFS HDD
Sound not working after using YouTube for a while
No option to connect to wifi
Profile problem with 2015.09 - 2
Full-bluray choppy video playback on last OSMC version
Kodi restarts after connecting to wifi
Cannot install any add-on
Cannot install any add-on
Live TV Fail
Cannot mount NFS share in GUI (works in terminal)
Wireless Network Card Hangs since September updates
Make wiki article "How to submit a ... support requst" a sticky note, here
Make wiki article "How to submit a ... support requst" a sticky note, here
About the Help and Support category
"Recently added movies" and "Recently added episodes" not updating
MYSQL issue on October Update
3d Movies with TrueHD freezing after skip forward or resume
Vero 2 Blank Video Playback after April Update
Wifi not reconnecting on reboot
OMSC crashed
Files not showing on SMB share, only folders
How to automatically update library?
About the Vero 2 category
Osmc update error krypton
Iptv Simple Client Channel zapping slow
Potential graphical glitches and freezes fix
New Router - new password not permanent
Kodi Jarvis 16.1 Crash when getting into Soundcloud addon
I have installed osmc on my 27 inch screen running on a mac but when i boot up i only get a black screen
Iis this normal?
Official Remote & Raspberry Pi 3 - Bottom Half Not Working
Installer not seeing SD cards on OS X
[TESTING] Kodi 17 (Krypton) builds for Raspberry Pi (continued)
Bluetooth keyboard not working on kodi 17
Buffering/Stuttering of 1080p Videos
.mkv file Audio but no video
Web Interface broken
Error installing
App Store doesn't work
The forum needs a sticky!
KODI 17 on RPi, very slow start of viewing
Cant't apply lirc.conf from My OSMC Remotes
CEC problem since April update
HDMI-cec is broken
Playback freezes inconsistently over NFS
Missing "Add Source" and missing videos after April Update
Low brightness after update
Disk full on EXT4 partition
Network problems following OpenVPN instal / system update
Playing Blu Ray backups?
Library clean causing the Vero to hang/crash
[Kodi 19] HDMI extractor's audio stopped working
PVR IPTV Simple Client/Live TV XMLTV Guide Bug?
OSMC's April update is here
Blank Screen on startup
Access to A Replay Volume Control Kodi 17.1 May 2 2017 Pi3B
Python broken
Broken remote RF receiver?
Error while installing latest update
Error while installing latest update
CyberGhost Openvpn
April Update made CEC worse, not better
Rasp 3 fail on USB
Tvheadend won't scan
How to change Wi-Fi password?
USB WiFi adapter Ralink RT7601 not work on Pi2
Reboot after selecting file
Buffering on Dailymotion after update
Everytime i switch with my remote to OMSC, OSMC crashes
Frameskipping in some 4K files
Nothing works in Kodi 17.3 after may update
HDMI-CEC stopped working after May update on LG and Samsung TVs
[TESTING] Debian Stretch upgrade for OSMC
[SOLVED] RP3: Massive Load, constant crashes, low CPU usage
Transmission and Sickrage doesn't run at machine startup
After April update: Kodi has HW acceleration / rendering problems
Vero 4k WiFi problems
OSMC can't access Windows shares
Vero 4K crashes on a certain movie
Lost sound on everythig
NFS FSTAB mount not working on boot anymore
OSMC Vero can't output 60Hz through Denon AVR
New Vero 4K unable to see any WiFi Networks
Kore, ssh and Webaccess not working
Hdmi Audio Issues - Pi3
Can't set Media View to Wide
Unable to playback BBC recording from TVHeadend with DD 5.1 Audio
Ivalid format coming up on screen
Vero 4K+ not recognising external HDD and not uploading iptv channels
OSMC with Noobs, no wifi
Can you get rid of the new underline in the July update?
Smb only works after logging through SSH
No more dts or hdma on Vero4k+ only digital pcm 5.1
Osmc no sound from Audio Usb Pnp Sound device after upgrade to kodi 19
Very new user needs help
Movie scraping not finding titles
Problem on updating OSMC: 16-tzdata (2018i-0+deb9u1)
CLS Realtek Gigabit Ethernet Adapter not Working with Vero 4k
Problem after latest update with Vero4K+
Vero 4k unmounts my USB drive randomly
"Play disc" sometimes doesn't appear while disc can be played
Rhythmic Freezing Of 4K Movies/TV Series After November Update
CAN Module and OSMC
Washed-out colours with Plex and HDR
Networking Add On - Unhandled Exception Caught
WiFi or No WiFi
Simple Pvr unstable raspberry pi 1
Kodi only plaus first video
Cmyth playback issue
OSMC freeze after long time unused
No audio when playback
OSMC freeze after long time unused