Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@afonsojramos
Copy link
Member

@afonsojramos afonsojramos commented Dec 15, 2025

Fixes #188 by replacing all 19 Imgur-hosted images with locally-hosted versions. This ensures documentation is accessible to users in regions where Imgur is blocked, including the UK.

Images organized in static/images/ by category:

  • faq/ - 4 Musixmatch token images
  • extensions/ - 10 extension demo images
  • apps/ - 3 custom app demo images
  • development/ - 2 JavaScript module images

All markdown references updated to use relative paths instead of Imgur URLs.

Summary by CodeRabbit

  • Documentation

    • Updated image references across multiple docs to load from the repository instead of external hosts.
  • Chores

    • Image-compression workflow refined (now triggers on opened PRs, covers additional image formats, and updates checkout action).
    • Added project tool configuration specifying Node and Bun versions.

✏️ Tip: You can customize this high-level summary in your review settings.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Dec 15, 2025

Deploying spicetify-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6a9822b
Status: ✅  Deploy successful!
Preview URL: https://c92983c7.spicetify-docs.pages.dev
Branch Preview URL: https://megathink.spicetify-docs.pages.dev

View logs

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 69.8%, saving 3.3 MB.

Filename Before After Improvement Visual comparison
static/images/extensions/queue-all-demo.png 835.9 KB 242.1 KB 71.0% View diff
static/images/apps/reddit.png 551.6 KB 156.1 KB 71.7% View diff
static/images/extensions/keyboard-demo.png 442.6 KB 119.4 KB 73.0% View diff
static/images/extensions/shuffle.png 434.1 KB 121.5 KB 72.0% View diff
static/images/apps/new-releases.png 397.9 KB 116.8 KB 70.6% View diff
static/images/extensions/full-app-display.png 382.9 KB 176.3 KB 54.0% View diff
static/images/extensions/popup-lyrics.png 274.4 KB 74.1 KB 73.0% View diff
static/images/faq/mxm3.png 262.4 KB 65.0 KB 75.2% View diff
static/images/extensions/bookmark.png 230.4 KB 72.0 KB 68.7% View diff
static/images/extensions/trash.png 202.2 KB 52.7 KB 73.9% View diff
static/images/faq/mxm1.png 215.8 KB 68.8 KB 68.1% View diff
static/images/faq/mxm2.png 190.1 KB 44.7 KB 76.5% View diff
static/images/extensions/christian-demo.png 145.3 KB 50.9 KB 65.0% View diff
static/images/apps/lyrics-plus.png 64.2 KB 26.0 KB 59.5% View diff
static/images/extensions/dj-demo.png 58.4 KB 26.7 KB 54.2% View diff
static/images/development/js-modules-1.png 30.0 KB 7.5 KB 75.2% View diff
static/images/extensions/loopy-loop.png 28.1 KB 10.1 KB 64.1% View diff
static/images/faq/mxm4.png 27.9 KB 12.4 KB 55.4% View diff
static/images/development/js-modules-2.png 18.5 KB 4.7 KB 74.8% View diff

@coderabbitai
Copy link

coderabbitai bot commented Dec 15, 2025

Walkthrough

Replaced external Imgur image URLs with local repository image paths in multiple documentation files; updated CI image-compression workflow triggers and action version; added a new mise.toml defining tool versions. No application logic changes.

Changes

Cohort / File(s) Summary
Documentation image path migration
docs/advanced-usage/custom-apps.md, docs/advanced-usage/extensions.md, docs/development/js-modules.md, docs/faq.md
Replaced Imgur/external image URLs (https://i.imgur.com/...) with local repository paths (/images/...). Only Markdown asset references changed; content and structure unchanged.
CI workflow update
.github/workflows/compress_images.yml
Modified workflow trigger to run on PR opened only, added **/*.png and **/*.webp to watched file types, bumped actions/checkout from v2 → v4, and set compressOnly: true for calibreapp/image-actions@main.
Tooling config added
mise.toml
New file introducing a [tools] section with node = "24" and bun = "latest". No runtime code changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Docs: quick verification that local images exist and render as intended.
  • Workflow: confirm trigger change is intentional, actions/checkout@v4 compatibility, and compressOnly: true parameter semantics.
  • mise.toml: check format and intended placement; ensure CI/dev tooling will read it.

Poem

🐇 I hopped through docs at dawn’s first light,
Freed pictures trapped behind Imgur's night.
CI tweaked, a tiny tune,
Tools noted for a brighter noon —
Docs now display; the rabbit's pleased delight.

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The PR includes updates to .github/workflows/compress_images.yml and mise.toml that extend beyond the core objective of replacing Imgur images with local alternatives. Remove changes to compress_images.yml workflow and mise.toml file, or document their necessity for supporting the image migration. These appear unrelated to the primary goal of fixing image accessibility.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: replacing Imgur images with local alternatives, which is the primary objective across all modified files.
Linked Issues check ✅ Passed All image references in documentation have been updated from Imgur URLs to local paths organized by category, directly addressing issue #188's requirement to restore image accessibility.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch megathink

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
docs/advanced-usage/extensions.md (1)

93-93: Fix hyphenated compound adjectives in documentation text.

LanguageTool flagged several instances where compound adjectives before nouns should use hyphens: "right click" → "right-click", "double click" → "double-click". This improves formal documentation clarity.

Apply this diff to fix the hyphenation issues:

- Auto skip explicit tracks. Toggle option is in Profile menu (top right button).
+ Auto skip explicit tracks. Toggle option is in Profile menu (top-right button).

- Full App Display: Minimal album cover art display with beautiful blur effect background. Activating button located in top bar. While in display mode, double click anywhere to exit. Right click anywhere to open setting menu.
+ Full App Display: Minimal album cover art display with beautiful blur effect background. Activating button located in top bar. While in display mode, double-click anywhere to exit. Right-click anywhere to open setting menu.

- Have easy access to a pop-up window with the current song's lyrics. Click at microphone icon on top bar to open lyrics windows. Right click at the same icon to open config menu to customize looks and lyrics providers priorities.
+ Have easy access to a pop-up window with the current song's lyrics. Click at microphone icon on top bar to open lyrics windows. Right-click at the same icon to open config menu to customize looks and lyrics providers priorities.

- This extension will append a Throw to Trashbin option in tracks and artists link right click menu.
+ This extension will append a Throw to Trashbin option in tracks and artists link right-click menu.

Also applies to: 101-101, 131-131, 145-145

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 09fee27 and 3b7db8e.

⛔ Files ignored due to path filters (19)
  • static/images/apps/lyrics-plus.png is excluded by !**/*.png
  • static/images/apps/new-releases.png is excluded by !**/*.png
  • static/images/apps/reddit.png is excluded by !**/*.png
  • static/images/development/js-modules-1.png is excluded by !**/*.png
  • static/images/development/js-modules-2.png is excluded by !**/*.png
  • static/images/extensions/bookmark.png is excluded by !**/*.png
  • static/images/extensions/christian-demo.png is excluded by !**/*.png
  • static/images/extensions/dj-demo.png is excluded by !**/*.png
  • static/images/extensions/full-app-display.png is excluded by !**/*.png
  • static/images/extensions/keyboard-demo.png is excluded by !**/*.png
  • static/images/extensions/loopy-loop.png is excluded by !**/*.png
  • static/images/extensions/popup-lyrics.png is excluded by !**/*.png
  • static/images/extensions/queue-all-demo.png is excluded by !**/*.png
  • static/images/extensions/shuffle.png is excluded by !**/*.png
  • static/images/extensions/trash.png is excluded by !**/*.png
  • static/images/faq/mxm1.png is excluded by !**/*.png
  • static/images/faq/mxm2.png is excluded by !**/*.png
  • static/images/faq/mxm3.png is excluded by !**/*.png
  • static/images/faq/mxm4.png is excluded by !**/*.png
📒 Files selected for processing (4)
  • docs/advanced-usage/custom-apps.md (3 hunks)
  • docs/advanced-usage/extensions.md (4 hunks)
  • docs/development/js-modules.md (1 hunks)
  • docs/faq.md (2 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/advanced-usage/extensions.md

[grammar] ~93-~93: Use a hyphen to join words.
Context: ...Filename:* autoSkipExplicit.js Auto skip explicit tracks. Toggle option is i...

(QB_NEW_EN_HYPHEN)


[grammar] ~101-~101: Use a hyphen to join words.
Context: ...n top bar. While in display mode, double click anywhere to exit. Right click anyw...

(QB_NEW_EN_HYPHEN)


[grammar] ~101-~101: Use a hyphen to join words.
Context: ...de, double click anywhere to exit. Right click anywhere to open setting menu. ![...

(QB_NEW_EN_HYPHEN)


[grammar] ~131-~131: Use a hyphen to join words.
Context: ...on top bar to open lyrics windows. Right click at the same icon to open config me...

(QB_NEW_EN_HYPHEN)


[grammar] ~145-~145: Use a hyphen to join words.
Context: ... option in tracks and artists link right click menu. ![Ext_Trash](/images/extens...

(QB_NEW_EN_HYPHEN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (4)
docs/advanced-usage/custom-apps.md (1)

76-76: All custom app images are properly present.

The three image files referenced in the custom-apps documentation (reddit.png, new-releases.png, lyrics-plus.png) exist in static/images/apps/ and are correctly linked in the markdown at lines 76, 89, and 104.

docs/development/js-modules.md (1)

24-24: Image files verified and present.

Both image references in docs/development/js-modules.md (lines 24, 28) correctly point to existing PNG files in the repository: static/images/development/js-modules-1.png and static/images/development/js-modules-2.png.

docs/faq.md (1)

72-72: All FAQ image files are present and correctly referenced.

The four Musixmatch token instruction images (mxm1.png through mxm4.png) exist in static/images/faq/ and are properly referenced in the markdown at lines 72, 76, 80, and 90.

docs/advanced-usage/extensions.md (1)

87-87: All referenced image files exist in the repository.

The image paths at lines 87, 95, 103, 117, 125, 133, 140, 147, 176, and 192 are correctly formatted and all corresponding PNG files are present in static/images/extensions/.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 10.7%, saving 111.3 KB.

Filename Before After Improvement Visual comparison
static/images/extensions/queue-all-demo.png 242.1 KB 212.4 KB 12.3% View diff
static/images/apps/new-releases.png 116.8 KB 97.4 KB 16.6% View diff
static/images/extensions/keyboard-demo.png 119.4 KB 102.1 KB 14.5% View diff
static/images/apps/reddit.png 156.1 KB 143.3 KB 8.2% View diff
static/images/extensions/shuffle.png 121.5 KB 109.6 KB 9.8% View diff
static/images/faq/mxm3.png 65.0 KB 59.1 KB 9.0% View diff
static/images/faq/mxm1.png 68.8 KB 64.0 KB 7.0% View diff
static/images/extensions/trash.png 52.7 KB 49.6 KB 5.8% View diff
static/images/faq/mxm2.png 44.7 KB 42.1 KB 6.0% View diff
static/images/apps/lyrics-plus.png 26.0 KB 24.2 KB 7.0% View diff
static/images/faq/mxm4.png 12.4 KB 11.3 KB 9.3% View diff
static/images/extensions/loopy-loop.png 10.1 KB 9.4 KB 6.3% View diff

7 images did not require optimisation.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 9.2%, saving 40.6 KB.

Filename Before After Improvement Visual comparison
static/images/extensions/queue-all-demo.png 212.4 KB 187.4 KB 11.8% View diff
static/images/apps/new-releases.png 97.4 KB 89.1 KB 8.5% View diff
static/images/extensions/shuffle.png 109.6 KB 103.4 KB 5.6% View diff
static/images/faq/mxm4.png 11.3 KB 10.6 KB 6.2% View diff
static/images/extensions/loopy-loop.png 9.4 KB 9.0 KB 5.1% View diff

14 images did not require optimisation.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 7.2%, saving 14.3 KB.

Filename Before After Improvement Visual comparison
static/images/extensions/queue-all-demo.png 187.4 KB 173.7 KB 7.3% View diff
static/images/faq/mxm4.png 10.6 KB 9.9 KB 6.5% View diff

17 images did not require optimisation.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 7.6%, saving 13.2 KB.

Filename Before After Improvement Visual comparison
static/images/extensions/queue-all-demo.png 173.7 KB 160.6 KB 7.6% View diff

18 images did not require optimisation.

@afonsojramos afonsojramos force-pushed the megathink branch 2 times, most recently from 5435e82 to e9ee414 Compare December 15, 2025 11:09
- Download 19 Imgur-hosted images to static/images/
- Update markdown references to use local paths
- Add mise.toml for Node.js 24 and Bun version management
- Fix compress_images workflow to only run on PR open

Fixes #188
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (2)
mise.toml (1)

1-3: Consider pinning the Bun version.

The Node version is pinned to "24", but Bun uses "latest", which may lead to non-deterministic builds across different setup times. If reproducibility is important, consider pinning Bun to a specific version.

docs/advanced-usage/extensions.md (1)

101-101: Apply hyphens to compound modifiers "click" phrases.

Several lines use unhyphenated click phrases that should be hyphenated per English grammar conventions:

  • Line 101: "double click" → "double-click" (appears twice on this line)
  • Line 131: "Right click" → "right-click"
  • Line 145: "right click" → "right-click"

Apply these diffs to fix the grammar:

- While in display mode, double click anywhere to exit. Right click anywhere to open setting menu.
+ While in display mode, double-click anywhere to exit. Right-click anywhere to open setting menu.
- Have easy access to a pop-up window with the current song's lyrics. Click at microphone icon on top bar to open lyrics windows. Right click at the same icon to open config menu to customize looks and lyrics providers priorities.
+ Have easy access to a pop-up window with the current song's lyrics. Click at microphone icon on top bar to open lyrics windows. Right-click at the same icon to open config menu to customize looks and lyrics providers priorities.
- This extension will append a Throw to Trashbin option in tracks and artists link right click menu.
+ This extension will append a Throw to Trashbin option in tracks and artists link right-click menu.

Also applies to: 131-131, 145-145

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3b7db8e and 6a9822b.

⛔ Files ignored due to path filters (20)
  • bun.lock is excluded by !**/*.lock
  • static/images/apps/lyrics-plus.png is excluded by !**/*.png
  • static/images/apps/new-releases.png is excluded by !**/*.png
  • static/images/apps/reddit.png is excluded by !**/*.png
  • static/images/development/js-modules-1.png is excluded by !**/*.png
  • static/images/development/js-modules-2.png is excluded by !**/*.png
  • static/images/extensions/bookmark.png is excluded by !**/*.png
  • static/images/extensions/christian-demo.png is excluded by !**/*.png
  • static/images/extensions/dj-demo.png is excluded by !**/*.png
  • static/images/extensions/full-app-display.png is excluded by !**/*.png
  • static/images/extensions/keyboard-demo.png is excluded by !**/*.png
  • static/images/extensions/loopy-loop.png is excluded by !**/*.png
  • static/images/extensions/popup-lyrics.png is excluded by !**/*.png
  • static/images/extensions/queue-all-demo.png is excluded by !**/*.png
  • static/images/extensions/shuffle.png is excluded by !**/*.png
  • static/images/extensions/trash.png is excluded by !**/*.png
  • static/images/faq/mxm1.png is excluded by !**/*.png
  • static/images/faq/mxm2.png is excluded by !**/*.png
  • static/images/faq/mxm3.png is excluded by !**/*.png
  • static/images/faq/mxm4.png is excluded by !**/*.png
📒 Files selected for processing (6)
  • .github/workflows/compress_images.yml (3 hunks)
  • docs/advanced-usage/custom-apps.md (3 hunks)
  • docs/advanced-usage/extensions.md (4 hunks)
  • docs/development/js-modules.md (1 hunks)
  • docs/faq.md (2 hunks)
  • mise.toml (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (3)
  • docs/advanced-usage/custom-apps.md
  • docs/development/js-modules.md
  • docs/faq.md
🧰 Additional context used
🪛 LanguageTool
docs/advanced-usage/extensions.md

[grammar] ~93-~93: Use a hyphen to join words.
Context: ...Filename:* autoSkipExplicit.js Auto skip explicit tracks. Toggle option is i...

(QB_NEW_EN_HYPHEN)


[grammar] ~101-~101: Use a hyphen to join words.
Context: ...n top bar. While in display mode, double click anywhere to exit. Right click anyw...

(QB_NEW_EN_HYPHEN)


[grammar] ~101-~101: Use a hyphen to join words.
Context: ...de, double click anywhere to exit. Right click anywhere to open setting menu. ![...

(QB_NEW_EN_HYPHEN)


[grammar] ~131-~131: Use a hyphen to join words.
Context: ...on top bar to open lyrics windows. Right click at the same icon to open config me...

(QB_NEW_EN_HYPHEN)


[grammar] ~145-~145: Use a hyphen to join words.
Context: ... option in tracks and artists link right click menu. ![Ext_Trash](/images/extens...

(QB_NEW_EN_HYPHEN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (5)
docs/advanced-usage/extensions.md (2)

87-147: Image URL replacements look good.

All 10 extension demo images have been consistently replaced with local paths under /images/extensions/. The relative path structure is correct and follows the PR's organization scheme.

Also applies to: 176-192


184-184: Line 184: External URL inconsistent with other images; local replacement image missing.

This image reference uses an external GitHub URL while all other extensions reference local paths (/images/extensions/{filename}.png). However, the suggested local replacement (/images/extensions/new-release.png) does not exist in the repository—the local extensions directory lacks this file. Additionally, this is a GitHub user URL rather than an Imgur link, which differs from the PR's stated scope of replacing Imgur images. Clarify whether: (1) this image needs to be downloaded and added to the local directory, or (2) the external reference was intentionally preserved for this extension.

.github/workflows/compress_images.yml (3)

3-4: Verify the intent of restricting the trigger to opened events only.

The workflow previously ran on all pull request events (or at least opened and synchronize), but now it's restricted to types: [opened] only. This means the image compression workflow won't run when new commits are pushed to an existing PR—it will only run when the PR is first created.

Please confirm whether this is intentional (e.g., for cost control) or if it should also include synchronize to re-run when the PR is updated:

    types: [opened, synchronize]

6-9: Good improvements to the workflow.

The expansion of watched file patterns to include **.png and **.webp aligns well with the addition of local PNG images in this PR. The upgrade from actions/checkout@v2 to actions/checkout@v4 is a solid maintenance improvement, bringing in performance fixes and newer features.

Also applies to: 18-18


21-28: The compressOnly parameter is valid and properly implemented.

The compressOnly: true parameter is a supported Boolean input for calibreapp/image-actions that performs image optimization without committing changes or posting summary comments—appropriate for workflows that handle commits separately.

@afonsojramos afonsojramos merged commit 4dc62e1 into main Dec 15, 2025
2 checks passed
@afonsojramos afonsojramos deleted the megathink branch December 15, 2025 12:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Imgur-hosted images inaccessible in UK

2 participants