It is recommended for most users if you don't plan on making changes to your local copy. Find the Quick-Peek for Discogs on the Chrome Webstore here.
Quick Peek for Discogs! Highlight any word or phrase on any web page and get an instant Discogs preview: artist bios and genres, album/release artwork and tracklists. It's a way to discover music while you're reading, without leaving the page to go search Discogs yourself.
This extension is built on the Manifest V3 Chrome extension specification, turning the Discogs database into a convenient inline lookup tool. Easily highlight any artist, album, or track name on any webpage and instantly see release details, cover art, and marketplace info without leaving the page.
- What it does
- How it works
- Setup
- Permissions
- Discogs API reference
- Project Structure
- Limitations
- Privacy
- Disclaimer
- Credits
- License
Quick-Peek puts the Discogs database one selection away from any text on the web:
- Select text → right-click → "Search Discogs for '…'", or
- Select text → release the mouse with Instant Select Lookup turned on in the popup, for a zero-click flow.
Either path uses the /database/search endpoint and renders a floating tooltip near your cursor with the best-matching result — without ever navigating away from the page you're on.
Example Usage Patterns:
| You selected... | Quick-Peek shows... |
|---|---|
An artist name (The Beatles) |
Photo, genre tags, and their 5 most recent releases |
An album/release title (Head Hunters) |
Cover art, year, format and the full tracklist |
A song title (The Great Gig in the Sky) |
The track name plus its parent album's cover, title, and artist. Though, it's a hit or miss. Albums show more frequently in discogs search results than a particular track. |
| Anything else | Its single best-guess match, with five ranked alternatives underneath in case the guess is wrong |
NOTE: These are idealized results, so in future updates, it might stop reflecting these!
From any card, you can click an artist's name to jump to their artist page, or click a track to see which album it's from.
Example Usage:
- Click an album cover to see its full tracklist
- Each click pushes a new view onto an in-tooltip navigation stack
- Use the ← Back button to retrace your steps.
The extension has three parts that talk to each other only through Chrome's messaging APIs: (content.js) watches the page and renders the tooltip, (background.js) that handles REST-API with Discogs and finally (popup.js) for the popup for the token and settings.
A selection or right-click sends the query to the background.js, which searches Discogs, scores the results to pick the best match (weighing title overlap and popularity over raw search order), fetches that result's full details, and sends it back to render. Clicking deeper into a card repeats this by ID instead of by search, building the back-navigable stack inside the tooltip.
Install directly from the Chrome Web Store.
- Clone or download this repository.
cd <DesiredLocation>
git clone https://github.com/puttdlc/QuickPeekForDiscogs.git
git clone will allocate a folder for you, so no need to make an extra one.
- Load it as an unpacked extension:
- Open
chrome://extensions - Enable Developer mode (top-right toggle)
- Click Load unpacked and select the
QuickPeekForDiscogsfolder
- Open
- Get a Discogs Personal Access Token:
- Go to discogs.com/settings/developers (also linked from the extension popup footer)
- Generate a token under "Personal Access Token", and copy it to your clipboard.
- Paste the token into the extension popup and click Save Token, then reload any tabs you want the extension active on.
- (Optional) Toggle Instant Select Lookup on if you'd rather skip the right-click menu and have every text selection trigger a lookup automatically. Though, it is recommended to be used only for more intensive lookup sessions as it will trigger the lookup regardless of text length, which may be intrusive for your average browsing experiences.
Your token is stored only in chrome.storage.sync (synced via your Google account like any other Chrome extension setting) and is sent only to api.discogs.com as a query parameter on each request. This extension never touches any third-party server, and the extension has no backend of its own.
Declared in manifest.json:
storage— persist the API token and the instant-lookup preference.contextMenus— add the "Search Discogs for…" right-click item.host_permissions: ["https://api.discogs.com/*"]— the only network endpoint the extension is allowed to talk to.content_scriptsmatching<all_urls>— the tooltip/selection logic needs to run on whatever page you're reading; it does not requestactiveTab-level page-content access beyond rendering its own UI.
This project is built entirely on Discogs's public REST API:
- API documentation: discogs.com/developers
- Authentication: Personal Access Tokens (simplest auth method; full OAuth 1.0a flow exists but isn't needed for read-only personal use)
- Database endpoints used:
GET /database/search— full-text search across artists, releases, masters, and labelsGET /artists/{artist_id}andGET /artists/{artist_id}/releasesGET /masters/{master_id}GET /releases/{release_id}
- Rate limits: authenticated requests are capped at
60 requests per minuteper Discogs's published limits. Drilling into deeply nested results (e.g. an artist card, which fires two parallel requests plus a follow-up genre lookup) consumes more of that budget than a flat release lookup; be mindful if you're rapid-firing lookups across many tabs.
manifest.json— MV3 manifest: permissions, content script registration, action/popup wiringbackground.js— service worker: Discogs API calls, result ranking, context menu registrationcontent.js— injected into every page: tooltip UI, drill-down nav, selection/click listenerspopup.html— toolbar popup markup and scoped stylespopup.js— popup logic: reads/writeschrome.storage.syncfor the token and instant-lookup toggleLICENSE— MIT
- Search relevance is heuristic, not semantic.
pickBestResult/rankResultsis a scoring function over title overlap and community popularity, not a language model, so unusual phrasing or very short/ambiguous selections (single common words) can surface an unrelated top result. That's exactly what the "Or did you mean?" list is there to recover from. - No offline/cache layer — every lookup is a live round-trip to
api.discogs.com, so results reflect the current Discogs database in real time, but the extension is non-functional without a network connection or a valid token. - Genre tags on artist cards are inferred from one of the artist's releases (Discogs doesn't attach genres to the artist resource itself), so they reflect that release's tagging rather than a verified artist-level genre. So it's not entirely uncommon for the artist's genre to seem completely irrelevant to their work.
Quick-Peek does not collect, transmit, or store any analytics, telemetry, or browsing data. The only outbound network calls are to api.discogs.com, carrying your search query and your own Discogs token. Selected text never leaves the browser except as the literal search string sent to Discogs.
Read the full Privacy Policy in PRIVACY.md.
This is an independent, unofficial project and is not affiliated with, endorsed by, or sponsored by Discogs or Zink Media, LLC. "Discogs" is a trademark of Zink Media, LLC.
- Built on the Discogs API and the data contributed by the Discogs community.
- SVG Icons and Extension Icon downloaded/modified from feathericons!

