# Discrete

A focused Obsidian plugin for filtering files in the file explorer based on their frontmatter metadata. Keep your vault organized by hiding or showing files that match specific metadata criteria.

## Features

- **File Explorer Filtering**: Hide or show files in Obsidian's file explorer based on frontmatter metadata
- **Multiple Filter Operators**: Support for various comparison operators:
	- = (Equals exactly)
	- ∈ (Contains text)
	- ∃ (Field exists)
	- ⊂ (Includes value in list/array)
	- \> (Greater than)
	- \< (Less than)
- **Flexible Value Types**: Handle different types of metadata:
	- Text
	- Numbers
	- Arrays/Lists
	- Boolean (Yes/No)
- **Customizable Behavior**:
	- Choose to hide or show matching files
	- Combine multiple filters with AND/OR logic
	- Real-time filtering as you create and modify rules
- **Quick Filtering**: Right-click any file to instantly create filters based on its metadata

### Planned Features

- More filter operators and comparison types
- Filter presets and saved filter combinations
- Import/export filter configurations
- Enhanced UI for managing complex filter sets

## Installation

1. Open Obsidian Settings
2. Go to Community Plugins and disable Safe Mode
3. Click Browse and search for "Discrete"
4. Install the plugin
5. Enable the plugin in your Community Plugins list

## Usage

### Creating Filters

1. Open Settings → Discrete
2. Click "Add New Filter"
3. Configure your filter:
	 - Enter the metadata key (e.g., "tags", "status", "priority")
	 - Choose the operator (equals, contains, etc.)
	 - Select the value type
	 - Enter the value to match against

### Filter Behavior

- **Hide Matching Files**: When enabled, files that match your filters will be hidden. When disabled, only matching files will be shown.
- **Combine Filters with AND**: When enabled, files must match ALL filters to be affected. When disabled, files matching ANY filter will be affected.

### Quick Filtering

Right-click any file in the explorer and select "Filter by metadata" to quickly create a filter based on its metadata.

### Understanding Operators

- **=** (Equals): Exact match of the value
- **∈** (Contains): Checks if the value contains the specified text
- **∃** (Exists): Checks if the field exists in the frontmatter
- **⊂** (Includes): For lists/arrays, checks if the value is in the list
- **>** (Greater): For numbers, checks if value is greater than specified
- **<** (Less): For numbers, checks if value is less than specified

## Examples

1. **Hide Completed Tasks**:
	 - Key: "status"
	 - Operator: "equals exactly"
	 - Value Type: "text"
	 - Value: "completed"

2. **Show High Priority Notes**:
	 - Key: "priority"
	 - Operator: "greater"
	 - Value Type: "number"
	 - Value: "3"

3. **Filter by Tag**:
	 - Key: "tags"
	 - Operator: "includes"
	 - Value Type: "array"
	 - Value: "project"

## Support

If you encounter any issues or have suggestions for improvements, please visit the [GitHub repository](https://github.com/shkarlsson/obsidian-discrete) and create an issue.

## Development Note

This plugin was developed with [aider](https://aider.chat). Contributions and feedback are welcome!

## Credits

Created by shkarlsson

## License

This project is licensed under the MIT License - see the LICENSE file for details.