explaingit

obsidianmd/obsidian-releases

Analysis updated 2026-06-24

17,702Audience · developerComplexity · 1/5Setup · easy

TLDR

The submission registry that lists every community plugin and theme shown inside the Obsidian app, plus official release downloads.

Mindmap

mindmap
  root((obsidian-releases))
    Inputs
      Plugin JSON entry
      Theme JSON entry
      Pull request
    Outputs
      community-plugins.json
      community-css-theme.json
      Official release downloads
    Use Cases
      Submit a plugin
      Submit a theme
      Download Obsidian binaries
    Tech Stack
      JSON
      GitHub Releases
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Submit a new community plugin to appear in Obsidian's plugin browser

USE CASE 2

Submit a new visual theme to the Obsidian theme gallery

USE CASE 3

Look up where to download official Obsidian app binaries

What is it built with?

JSON

How does it compare?

obsidianmd/obsidian-releasesflutter/pluginsimmersive-translate/immersive-translate
Stars17,70217,70717,696
LanguageDart
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

You also need a separate GitHub repo with your plugin's release assets.

In plain English

Obsidian is a note-taking app that stores your notes as plain text files on your own computer. This repository is not the app's source code, it serves two purposes: it hosts official release downloads for Obsidian, and it acts as the directory that Obsidian uses to display community-made plugins and themes inside the app. When you open Obsidian's plugin browser or theme store, the app reads from the JSON files in this repo to build its list of available options. For plugins, it pulls the name, author, and description from the community-plugins.json file, and when you click install, Obsidian fetches the actual plugin files from that plugin's own GitHub release page. Themes work similarly via the community-css-theme.json file. If you are a developer who has built a plugin or visual theme for Obsidian and wants it listed in the official browser, you submit it here by opening a pull request, adding a small entry to the appropriate JSON file with your plugin's ID, name, author, and a link to your GitHub repository. The Obsidian team then reviews the submission against their developer policies before approving it. This repo does not accept bug reports or general questions. Issues about the core Obsidian app should go to the Obsidian community forums, and issues with a specific plugin belong in that plugin's own repository. It is maintained by the Obsidian team (obsidianmd) and has no primary programming language since it is mostly configuration and data files.

Copy-paste prompts

Prompt 1
Walk me through submitting my Obsidian plugin to community-plugins.json including the exact JSON fields required
Prompt 2
Help me write the pull request description for adding my Obsidian theme to community-css-theme.json
Prompt 3
Check whether my plugin manifest meets Obsidian's developer policies before I open a PR here
Prompt 4
Tell me what fields I need in my plugin's GitHub release for Obsidian to install it correctly

Frequently asked questions

What is obsidian-releases?

The submission registry that lists every community plugin and theme shown inside the Obsidian app, plus official release downloads.

How hard is obsidian-releases to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is obsidian-releases for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub obsidianmd on gitmyhub

Verify against the repo before relying on details.