{"id":22396365,"url":"https://github.com/vincenzocaputo/obsidian-mitre-attack","last_synced_at":"2025-07-09T03:10:22.898Z","repository":{"id":189133429,"uuid":"649025334","full_name":"vincenzocaputo/obsidian-mitre-attack","owner":"vincenzocaputo","description":"Parse MITRE ATT\u0026CK to markdown for Obsidian","archived":false,"fork":false,"pushed_at":"2025-05-31T18:15:26.000Z","size":817,"stargazers_count":27,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-01T06:07:10.239Z","etag":null,"topics":["markdown","mitre-attack","obsidian","stix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vincenzocaputo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-06-03T14:37:41.000Z","updated_at":"2025-05-31T18:15:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"ed1adac1-086a-4c6d-a63b-f9a9db47421e","html_url":"https://github.com/vincenzocaputo/obsidian-mitre-attack","commit_stats":null,"previous_names":["vincenzocaputo/obsidian-mitre-attack"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/vincenzocaputo/obsidian-mitre-attack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincenzocaputo%2Fobsidian-mitre-attack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincenzocaputo%2Fobsidian-mitre-attack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincenzocaputo%2Fobsidian-mitre-attack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincenzocaputo%2Fobsidian-mitre-attack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vincenzocaputo","download_url":"https://codeload.github.com/vincenzocaputo/obsidian-mitre-attack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincenzocaputo%2Fobsidian-mitre-attack/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264384389,"owners_count":23599612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","mitre-attack","obsidian","stix"],"created_at":"2024-12-05T06:07:50.901Z","updated_at":"2025-07-09T03:10:22.892Z","avatar_url":"https://github.com/vincenzocaputo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# obsidian-mitre-attack\n\nThis repository implements a Python script that parses the MITRE ATT\u0026CK knowledge base into a markdown format, making it readable and browsable using the Obsidian note-taking app. \nThe ATT\u0026CK data is retrieved from the MITRE GitHub repository (https://github.com/mitre-attack/attack-stix-data) that contains the dataset represented in STIX 2.1 JSON collection. \n\nThe main idea behind this project is to make the MITRE ATT\u0026CK knowledge base easily accessible and seamlessly integrable into Obsidian, along with reports or your personal notes. Utilizing Obsidian's features such as hyperlinks, tags, graph view, and more can greatly support threat intelligence analysis and investigations.\n\n## Quick Start\n\n### Installation\n\nClone this repository\n\n```\ngit clone https://github.com/vincenzocaputo/obsidian-mitre-attack.git\n```\nCreate a Python virtual environment\n\n```\ncd obsidian-mitre-attack\npython3 -m venv venv\nsource venv/bin/activate\n```\n\nInstall Python module dependencies\n```\npip install -r requirements.txt\n```\n\n### Run\n\n#### Edit the config file (Optional)\n\n\u003e **It is recommended to use the default config file.**\n\n\nIn the `config.yml` file, you can change the following options:\n\n- **repository-url**: The base URL pointing to the mitre/attack-stix-data repository. You can define also a local file path or other URLs. However, remember that this project is intended to parse data from the MITRE ATT\u0026CK framework. Providing different JSON files may break the script execution.\n- **version**: The ATT\u0026CK version to pull. You can remove this entry to pull the latest version. Please note that newer versions may not have been tested and some errors may occur. In case of an error, do not hesitate to open a problem.\n- **mitre-object-types**: This option lists all the type of MITRE objects that are parsed by the script. You can set to `false` the options corresponding to the types of objects for which you don't want to create markdown notes in your vault.\n\n\n#### Run the script\nRun the application specifying the output directory path (i.e.: your obsidian vault)\n\n```\npython run.py -o obsidian_vault_path\n```\n\n### Options\n\n```\nusage: . [-h] [-d DOMAIN] [-o OUTPUT] [--generate-hyperlinks] [--generate-matrix] [--path PATH]\n\nDowndload MITRE ATT\u0026CK STIX data and parse it to Obsidian markdown notes\n\noptions:\n  -h, --help            show this help message and exit\n  -d DOMAIN, --domain DOMAIN\n                        Domain should be 'enterprise-attack', 'mobile-attack' or 'ics-attack'\n  -o OUTPUT, --output OUTPUT\n                        Output directory in which the notes will be saved. It should be placed inside a Obsidian\n                        vault.\n  --generate-hyperlinks\n                        Generate techniques hyperlinks in a markdown note file\n  --generate-matrix     Create ATT\u0026CK matrix starting from a markdown note file\n  --path PATH           Filepath to the markdown note file\n```\n\n\n\n## Images and Examples\n\n![immagine](https://github.com/vincenzocaputo/obsidian-mitre-attack/assets/32276363/f9e3aa4d-fdae-44b7-9036-616ed9f61d69)\n\n![immagine](https://github.com/vincenzocaputo/obsidian-mitre-attack/assets/32276363/67b600e4-9928-494e-ac55-bd1e2e2f1ddd)\n\n![image](https://github.com/user-attachments/assets/b34ed6fa-b799-4e53-986a-f43d9c09bd57)\n\n![image](https://github.com/user-attachments/assets/b642d906-f280-4899-87cb-95f69db2249b)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvincenzocaputo%2Fobsidian-mitre-attack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvincenzocaputo%2Fobsidian-mitre-attack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvincenzocaputo%2Fobsidian-mitre-attack/lists"}