OSMC Skin Scope Mask feature

I’ll think about a way to maybe implement an optional way of setting the masking aspect ratio via specific filename tags. Not absolutely sure though. Will let you know, if I come up with something convincing that’s as user-friendly and as little intrusive as possible. :+1:t2:

This has been a quick one… I wasn’t comfortable implementing anything like this for all users without any options, but I’ve found a convenient way to add this in an optional manner. If one wishes to let the skin adjust the masking aspect ratio during playback automatically, it will be possible to enable this via a skin setting and a couple of filename tags that I’ll add to the OSM Skin wiki article once implemented:

The set value above this new setting will be the fallback and what’s being used while video playback is not active. Once video playback is active, the skin will look for a tag in the filename and set the masking aspect ratio accordingly. The tags will be in this format: ‘.scope240’, ‘.scope235’, ‘.scope233’, ‘.scope200’. If there’s no tag, the skin will disable masking during video playback. So, tags will only be necessary for videos that are not at a 16:9 aspect ratio.

I hope, this will add exactly what you were looking for, @radschi :+1:t2:

@Chillbo: Wow, is was really fast! :+1: :+1:

I can try it out in the next few days and let you know the result.
One suggestion: There is a software availiable, called “Aspect Ratio Detector”, which can scan all movies to find out the correct ratio and add it to the file name like “_AR240”, “_AR233”… automatically.

You can find it here: Aspect Ratio Detector: Seitenverhältnis erkennen - HTPC & Mediaplayer - Heimkinoverein
Unfortunately, its a german website, but maybe you can understand it (I am from Austria, so its my first language too).

I want to use this tool to tag all movies with the ratio and then it should be possible to use your new feature without much fiddling with the filenames manually, means if you can change your tag to the same format then this is perfect :wink:

Thank you again for your fast effort.

You could use a renaming utility to change any “_AR240” to “.scope240” quite easily.

I can have a look at that and see what works best. Will also check out how the other rare CIH/scope skins are doing this. Maybe this would be a good approach for other users as well.

I’ve checked the very few other scope skins around and the .AR240. format tag is indeed the most common. If either .AR178., .AR200., .AR233., .AR235. or .AR240. (surrounded by any combination of -, .or _) are present in the file or folder name (and if the automatic masking aspect ratio feature is enabled) the masking aspect ratio will be set automatically. If none of these five tags are present, the masking aspect ratio will rely on the custom value set in the skin settings. After video playback has stopped, the aspect ratio will also fall back to that value.

I’ll push the changes later today. Then you’ll be able to test :slightly_smiling_face:


Renaming is not good because i use another tool which relay also on this naming schema to adjust the lens on my beamer automatically.

Please don’t forget also AR133, i have some older TV-Shows in this old ratio. :flushed:

About testing, it will take some time, because i need to rename all movies with the scanning tool.

This new feature has now been pushed to Git: GitHub - osmc/skin.osmc at scope

I’m confused now as I’ve adopted the exact format you suggested now. See here. Why would you need renaming now?

The above listed aspect ratios are the ones we support atm - we can’t support all aspect ratios possibly out there, tbh. 1.33:1 is a format which doesn’t need masking, but rather pillar boxing and can otherwise be treated as 16:9 (alias 1.78:1). As it won’t be detected, you simply have to select 1.78:1 masking manually during playback for this aspect ratio. Or you tag it as AR178 which would make a lot more sense IMHO.


Sorry for confusing you, but @darwindesign suggested to use a renaming tool. It was my fault :slightly_frowning_face: to reply to you instead of him.

Your naming schema is allready ok :slight_smile:

And yes, you are right, 1.33:1 has the same height as 16:9 :point_up:

1 Like

I’ve slightly reworked this feature again, so please pull the scope skin zip again, if you have downloaded it already. :+1:t2:

@radschi, just asking for a followup… Have you been able to test the feature? Would like to make sure it’s working as intended for release in a next update :slightly_smiling_face:

@Chillbo, sorry for my late reply, but I was on vacation and other things came up, but now:

I did a few tests with my movies. Basically it is working as it should be :+1:, but i am missing some aspect ratios, which are detected with the “Aspect Ratio Detector” tool: AR133, AR167, AR185, AR222, AR276

I know that AR133 and AR167 has the same like AR178 but maybe you can make an “or” logic (AR133 or AR167 or AR178 =>AR178) otherwise i need to rename all files with the “wrong” AR178.
In the future i want to control two motorized curtains on the left and right side to mask the projection screen width, depending from the tags AR133/AR167 or other tags, so i need the correct tags.

The other missing aspect ratios have a different height, so please can you add them too?

So you could support all aspect ratio’s which can be dedected by this tool (1.33 1.67 1.78 1.85 2.00 2.22 2.35 2.40 2.76). This tool can also round up/down to the next aspect ratio like AR233 → AR235.

And it will be also a nice feature to get the AR shown in the OSD instead of the word “Auto”

And thank you again for your skin :+1: :+1:


Unfortunately, this is gonna be a quick one: I’m not gonna add any more aspect ratios for a single setup that is using a very specific tool that is only to be found on a German home cinema forum that’s not very much known in the first place.
Sorry, but this is too much to ask. The scope skin is a feature I’m happy to offer as it wasn’t too much work, but it’s just one feature used by a couple of users in very custom environments from what I can see.

1.33:1 can’t be supported - as I said before - because it would mean adding vertical masking (including having to limit controls to an area smaller vertically as well) - the same applies to 1.67:1. Everything between 1.78:1 (16:9) and 2.40:1 (1920x800 pixel window that all of the UI controls sit in - meaning that 2.76:1 is not possible) is technically possible, but not reasonable to add and maintain as there’s basically an infinite amout of aspect ratios out there. What the scope skin supports are reasonable aspect ratios a fixed scope screen would come in. What I suggest here are two things:

  • avoid vertical masking as there’s no skin out there supporting this (and there probably won’t be as it’s hard to implement AND the Kodi skin engine is not made for any of this)
  • rely on the tags supported now and automatically convert the ones not supported (or too specific/custom) with an automatic renaming tool (search for e.g. ‘AR133’ in your media folders and replace by ‘AR178’)

That’s all I can advise here as I can’t add all possible aspect ratios for technical and maintenance reasons. The logic of the supported aspect ratios currently is what a project screen would likely cover and not which possible aspect ratios movies/TV shows out there have. That won’t change. :slightly_smiling_face:

I hope, you can live with this approach and adjust your setup to work with this.

The logic here is that the OSD should reflect what the skin currently does. As long as the skin is in automatic mode (file name tag detection), it should show that it actually is picking up a tag. If the file played back doesn’t have a proper tag, the skin will fall back to the aspect ratio currently set - this means the ‘Auto’ label will be replaced by the aspect ratio set. I can’t add both, a hint to the automatic aspect ratio switching AND the aspect ratio set/used, to this small button, so one approach has to be chosen. Showing that the skin does something automatically outweighs the need to show what the current automatic aspect ratio is. I’ll see whether I can add a hint somewhere else that shows which aspect ratio is being picked up from the file name while automatic mode is active. But this is just a small gimmick, so don’t get your hopes up. :wink:

Will the scope skin be updated for Kodi 19? Thanks

It’s already ready for v19

Sam, can I download the v19 version?

This link hasn’t changed. It’s the Matrix scope skin already.

Hi Sam, I tried the link and it would not install on kodi 19.1, could you please test scope edition for 19.1 r4 or has anyone got it working. Works perfect on 18.9
Highly recommended for older projectors when using a 21:9 wall painted fixed screen to keep the skin frammed inside the 21:9 ratio and mask off the horrible extra light spillage above and below. Probably saves on your bulb/lamp life as well?

Which link have you used and which scope version have you installed exactly?

Hi, I got it working, I am on 18.9 (9.2.7). Coreelec. How come this feature is not on all skins? Best skin ever!