What does this document describe?

# Obsidian Tasks Custom Icons

This repository contains a commandline tool (for developers/designers) to easily create CSS snippets that when added to Obsidian will replace the emojis used by the [Obsidian Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks) with monotone icons matching the text colour.

As a Tasks end-user, you can simply [install](https://help.obsidian.NAME_1/Extending+Obsidian/CSS+snippets) one of the generated CSS snippets below to your obsidian vault to replace the [Tasks Emoji Format](https://publish.obsidian.NAME_1/tasks/Reference/Task+Formats/Tasks+Emoji+Format) emojis with monochrome icons.

## Lucide-based Icon set 2

![Lucide-based icon theme 2 screenshot](TasksMonoEmojis-lucide2/screenshot.png)

[Download CSS Snippet](https://raw.githubusercontent.com/replete/obsidian-tasks-custom-icons/main/lucide2/obsidian-tasks-lucide2-icons.css)

Icons modified from https://lucide.dev

## NotoEmoji-based Icon set

![NotoEmoji-based icon them2 screenshot](TasksMonoEmojis-notoemoji/screenshot.png)

[Download CSS Snippet](https://raw.githubusercontent.com/replete/obsidian-tasks-custom-icons/main/lucide2/obsidian-tasks-lucide2-icons.css)

Icons extracted from Google's [Noto Emoji](https://github.com/googlefonts/noto-emoji/blob/main/fonts/NotoColorEmoji.ttf) variable TTF font. Unsurprisingly, putting their contours through this workflow does not yield a great result.

## Lucide-based Icon set

![Lucide-based icon theme screenshot](TasksMonoEmojis-lucide2/screenshot.png)

[Download CSS Snippet](https://raw.githubusercontent.com/replete/obsidian-tasks-custom-icons/main/lucide/obsidian-tasks-lucide-icons.css)

Date and recurring icons modified from https://lucide.dev

## EmojiTwo-based Icon set

![EmojiTwo-based icon theme screenshot](TasksMonoEmojis-emojitwo/screenshot.png)

[Download CSS Snippet](https://raw.githubusercontent.com/replete/obsidian-tasks-custom-icons/main/emojitwo/obsidian-tasks-emojitwo-icons.css)

Date and recurring icons modified from https://github.com/EmojiTwo/emojitwo/tree/master/svg_bw


## Creating a custom icon set

**Prerequisites:** Node.JS must be installed. I cannot provide support if this is unfamiliar, but it is fairly straightforward:

- Clone/fork/download this repository
- From a terminal, run `npm install` from the cloned/forked/downloaded directory
- Duplicate the `TaskMonoEmojis-notoemoji` folder, renaming it to your new icon set name, e.g. `TaskMonoEmojis-fancyicons`. Folder naming format: `{font name}-{icon set name}`. The font nam