Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

systems-endpoint-graphics_public-repo

Biola University IT Systems Engineering's collection of icons and graphics for software deployed to endpoints (primarily via Jamf / Installomator / Baseline). The goal: never have to search for or manually upload an icon again — reference a stable URL from this repo instead.

Using an icon

Every icon is served as a raw file straight from GitHub:

https://raw.githubusercontent.com/biola/systems-endpoint-graphics_public-repo/main/software/<slug>.png

For example, Slack's icon: https://raw.githubusercontent.com/biola/systems-endpoint-graphics_public-repo/main/software/slack.png

A small number of icons come from sources that only published a low-resolution, colour-quantized original (a 256x256 8-bit PNG with a dithered gradient). Those are reconstructed at render time — the dither pattern is resolved back into a smooth gradient rather than being scaled up into visible grain — so they may read very slightly softer than a vector-sourced icon, but not speckled.

All software/*.png files are 512x512 PNGs with the icon content normalized to fill ~90% of the canvas (a consistent margin regardless of source), so icons from different sources look consistent side-by-side — this matters because tools like Baseline (built on swiftDialog) display supplied PNGs as-is with no automatic padding of their own.

Folder structure

software/
├── <slug>.png             # primary asset — 512x512, ~90% content fill, transparent padding
├── svg/<slug>.svg         # vector original, only when the winning source provided one
└── variants/               # kbareis-sourced apps only: every OTHER captured mode (Tahoe
                            # light/dark/clear/tinted + legacy) not picked as primary, as a
                            # flat directory of original kbareis filenames (see manifest.json's
                            # kbareis_variants list per slug to find an app's variants)

software-old/               # the pre-2026-07-17-revamp software/ build, kept for rollback

generic/
└── monochrome/
    ├── <slug>.svg           # single-color brand glyph (simple-icons), transparent background
    └── on-light/<slug>.png  # same glyph pre-composited on white — safe on any background,
                              # since transparent black-on-transparent glyphs vanish on dark UIs

_meta/
├── manifest.json       # slug -> source/license/original-filename (+ per-icon creator credit
│                        # for macosicons.com-sourced icons) for every shipped icon
├── manifest-old.json   # manifest.json as it was before the 2026-07-17 revamp
├── DEDUP_LOG.md         # what got dropped as a duplicate and why, per pipeline run
├── KNOWN_GAPS.md        # requested apps no source could supply, with the reason why
└── RENDER_FAILURES.md   # any source files that failed to render (malformed SVGs, etc.)

Naming

Slugs are lowercase-kebab-case, normalized from the original app/product name (versions/years stripped — e.g. "Adobe Photoshop 2024" and "Adobe Photoshop 2025" both resolve to adobe-photoshop, since none of our sources track a distinct icon per release year).

Two deliberate exceptions:

  • Editions are kept when they're separate deployments with different art. "DaVinci Resolve (Free)" and "DaVinci Resolve (Studio)" would both normalize to davinci-resolve, so they ship as davinci-resolve-free and davinci-resolve-studio instead.
  • Some products are published under an additional alias slug when a deployment list names them differently than the upstream source did (e.g. quicktime-player alongside quicktime). Aliases are additive — the original slug's URL never changes. See the aliased-icons table in ATTRIBUTION.md.

Sources & licensing

See ATTRIBUTION.md for the full per-source license breakdown. Icons are pulled from multiple upstream collections, deduplicated, and standardized — see LICENSE.md for how licensing works across a mixed-source repo like this one.

Adding new icons

This repo is built and maintained via a scripted pipeline (acquire → dedupe → standardize → commit), not by hand-uploading individual files. If an icon you need is missing, check _meta/manifest.json for what's shipped and _meta/KNOWN_GAPS.md for apps already investigated and found unavailable — then reach out to IT Systems Engineering to have it added in the next pipeline run.

Please don't upload an icon directly into this repo, even to fix a bad one. Hand-supplied art is genuinely welcome — it's the highest-priority source and beats every upstream collection — but it has to enter through the pipeline, which is a separate step IT Systems Engineering runs. A file uploaded straight into software/ gets no manifest.json entry recording where it came from, skips the 512x512 and fill-ratio normalization (so it renders a different size than its neighbours in Baseline/swiftDialog), and — if it replaces an icon the manifest already tracks — is silently reverted to the old artwork the next time the pipeline runs. Send the file to IT Systems Engineering instead and it will be added properly, with attribution recorded.

Phasing

Phase 1 (superseded 2026-07-17): curated small sources pulled in full, plus dashboard-icons filtered to software Biola actually deploys (Installomator's supported-app list + an internal Mac-lab software inventory). simple-icons is included in full for generic monochrome glyphs. The software/ build from this phase is preserved at software-old/.

Phase 2 — squirqle/Tahoe revamp (current, 2026-07-17): re-prioritized software/ around the "squirqle" macOS app-icon shape and official Tahoe icon renders, in priority order: kbareis/icons (private, personally authorized) → JamfManager-Icons → macosicons.com (API, budget-capped gap-fill — retired 2026-08-04, see ATTRIBUTION.md; already-sourced icons remain) → dashboard-icons → svgl → HCSTech-icons (last-resort fallbacks). simple-icons generic monochrome glyphs are untouched by this revamp.

Phase 3 (not yet built): broader dashboard-icons coverage and selfhst/icons (self-hosted/homelab app icons), added only if real gaps show up in day-to-day use — deferred initially to avoid shipping thousands of icons for software Biola doesn't deploy.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors