Background Images in JSM are not set to 'fit screen' resulting in cropping on all sides. #60

Open
opened 2026-01-19 18:31:23 +00:00 by michael · 4 comments
Owner

Originally created by @Uggbert on GitHub.

As per the title

I have tried with the following image sizes:

5120x2880 (16:9)
6000x6000 (1:1)

If the background could be set to 'fit' that would be excellent.

Originally created by @Uggbert on GitHub. As per the title I have tried with the following image sizes: 5120x2880 (16:9) 6000x6000 (1:1) If the background could be set to 'fit' that would be excellent.
michael added the enhancement label 2026-01-19 18:31:23 +00:00
Author
Owner

@Uggbert commented on GitHub:

Yes this would be great.

On Wed, 18 Jun 2025, 09:50 Armin Briegel, @.***> wrote:

scriptingosx left a comment (jamf/Setup-Manager#124)
https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2983283001

Current behavior is "fill" which means it will scale the image up to fill
the screen, even if parts of the image would be cut off.

"fit" would scale the image up (or down) so that the whole image fits on
the screen, but leave grey areas to fill the remaining space. Is that what
you want?


Reply to this email directly, view it on GitHub
https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2983283001,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/AMF7CIHPIPIN2QJSSK33CF33EER6HAVCNFSM6AAAAAB7HQX6WGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSOBTGI4DGMBQGE
.
You are receiving this because you authored the thread.Message ID:
@.***>

@Uggbert commented on GitHub: Yes this would be great. On Wed, 18 Jun 2025, 09:50 Armin Briegel, ***@***.***> wrote: > *scriptingosx* left a comment (jamf/Setup-Manager#124) > <https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2983283001> > > Current behavior is "fill" which means it will scale the image up to fill > the screen, even if parts of the image would be cut off. > > "fit" would scale the image up (or down) so that the whole image fits on > the screen, but leave grey areas to fill the remaining space. Is that what > you want? > > — > Reply to this email directly, view it on GitHub > <https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2983283001>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/AMF7CIHPIPIN2QJSSK33CF33EER6HAVCNFSM6AAAAAB7HQX6WGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSOBTGI4DGMBQGE> > . > You are receiving this because you authored the thread.Message ID: > ***@***.***> >
Author
Owner

@scriptingosx commented on GitHub:

so, like this:

Image

(sample image has a square aspect ratio)

I have changed this from a bug to a feature. Current implementation works as it should. Implementing this request will require additional preference/profile keys.

@scriptingosx commented on GitHub: so, like this: ![Image](https://github.com/user-attachments/assets/9c62f630-2a8c-4dd4-b3aa-f53d768eb1f6) (sample image has a square aspect ratio) I have changed this from a bug to a feature. Current implementation works as it should. Implementing this request will require additional preference/profile keys.
Author
Owner

@scriptingosx commented on GitHub:

Current behavior is "fill" which means it will scale the image up to fill the screen, even if parts of the image would be cut off.

"fit" would scale the image up (or down) so that the whole image fits on the screen, but leave grey areas to fill the remaining space. Is that what you want?

@scriptingosx commented on GitHub: Current behavior is "fill" which means it will scale the image up to fill the screen, even if parts of the image would be cut off. "fit" would scale the image up (or down) so that the whole image fits on the screen, but leave grey areas to fill the remaining space. Is that what you want?
Author
Owner

@Uggbert commented on GitHub:

Yep, I would then just need to ensure my images are 16:9 or 16:10 aspect
ratio so they fit the screen with minimal/no cutoff/borders

https://en.m.wikipedia.org/wiki/Retina_display

Annoyingly Apple do not have a consistent resolution across models or
generations. But the aspect ratio can be put into 3 broad categories for
modern devices. 16:9 for iMac, 14:9 and 16:10 for Macbook, so I would play
about with an image resolution that covers these 3 with minimal black bars
when set to 'fit'

I assume 'fit' will scale the longest image resolution dimension to the
display and then leave black/white bars to the opposite sides to maintain
the aspect ratio and avoid image distortion:

A wider image will add bars to the top and bottom to ensure a fit, a taller
image will add bars to the left and right to ensure a fit ?

Hope that makes sense.

On Thu, 19 Jun 2025, 07:41 Armin Briegel, @.***> wrote:

scriptingosx left a comment (jamf/Setup-Manager#124)
https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2986818278

so, like this:

image.png (view on web)
https://github.com/user-attachments/assets/9c62f630-2a8c-4dd4-b3aa-f53d768eb1f6

(sample image has a square aspect ratio)


Reply to this email directly, view it on GitHub
https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2986818278,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/AMF7CIBPZEK2CCZZHMEIMUD3EJLQVAVCNFSM6AAAAAB7HQX6WGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSOBWHAYTQMRXHA
.
You are receiving this because you authored the thread.Message ID:
@.***>

@Uggbert commented on GitHub: Yep, I would then just need to ensure my images are 16:9 or 16:10 aspect ratio so they fit the screen with minimal/no cutoff/borders https://en.m.wikipedia.org/wiki/Retina_display Annoyingly Apple do not have a consistent resolution across models or generations. But the aspect ratio can be put into 3 broad categories for modern devices. 16:9 for iMac, 14:9 and 16:10 for Macbook, so I would play about with an image resolution that covers these 3 with minimal black bars when set to 'fit' I assume 'fit' will scale the longest image resolution dimension to the display and then leave black/white bars to the opposite sides to maintain the aspect ratio and avoid image distortion: A wider image will add bars to the top and bottom to ensure a fit, a taller image will add bars to the left and right to ensure a fit ? Hope that makes sense. On Thu, 19 Jun 2025, 07:41 Armin Briegel, ***@***.***> wrote: > *scriptingosx* left a comment (jamf/Setup-Manager#124) > <https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2986818278> > > so, like this: > > image.png (view on web) > <https://github.com/user-attachments/assets/9c62f630-2a8c-4dd4-b3aa-f53d768eb1f6> > > (sample image has a square aspect ratio) > > — > Reply to this email directly, view it on GitHub > <https://github.com/jamf/Setup-Manager/issues/124#issuecomment-2986818278>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/AMF7CIBPZEK2CCZZHMEIMUD3EJLQVAVCNFSM6AAAAAB7HQX6WGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSOBWHAYTQMRXHA> > . > You are receiving this because you authored the thread.Message ID: > ***@***.***> >
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jamf/Setup-Manager#60