https://github.com/chetachiezikeuzor/Pixr-Plugin

An Obsidian.md plugin that brings Unsplash, the largest open collection of high-quality photos, into Obsidian for a better image-use workflow 🌄.
https://github.com/chetachiezikeuzor/Pixr-Plugin

obsidian-md obsidian-plugin plugin unsplash-api

Last synced: 9 days ago
JSON representation

An Obsidian.md plugin that brings Unsplash, the largest open collection of high-quality photos, into Obsidian for a better image-use workflow 🌄.

• Host: GitHub
• URL: https://github.com/chetachiezikeuzor/Pixr-Plugin
• Owner: chetachiezikeuzor
• Created: 2021-06-17T14:38:40.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2021-12-29T00:28:49.000Z (almost 3 years ago)
• Last Synced: 2024-10-28T17:34:57.513Z (16 days ago)
• Topics: obsidian-md, obsidian-plugin, plugin, unsplash-api
• Language: TypeScript
• Homepage:
• Size: 26.4 MB
• Stars: 24
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
WIP

# Pixr

![](https://raw.githubusercontent.com/chetachiezikeuzor/Pixr-Plugin/master/assets/Pixr%20Header%20Demo.png)

Pixr is a plugin that harnassing the Unsplash's image database to add a custom image source and embedding tool 🎑. This plugin makes finding and emedding images much easier with just a few clicks.

## Demo

## Ease of Use

This plugin was created for note-takers that have a heavy image use with their workflow. Pixr is pretty simple to use as well! All you have to do is open the Pixr view using the Command Palette, then search for an image.

## How it Works

Unsplash's image database has just reached over 3million photos, which gives you a giant pool of images to choose from, right inside of your note-taking tool. Pixr appends links to the photographer of the images, and the image itself, so you can always go back to the source! When you search for an image using Pixr, you'll see two icon buttons. One is the wand icon, the other is the download icon. The wand button allows you to see a large preview of the image, so that you can get a good look before embedding into your note. When it comes to embedding images into your notes, there are two ways you can go about it. The first is by using the download button. This button runs a function that condenses the image to blob type, and then write the image as a file directly into your vault. You can also declare a folder to be used for downloading images. The second way is to drag and drop the image into your note. When you drag and drop the image, a base64 encode string is returned. Both methods grant you control over your new images, so that they are future proof!

## Installation

This plugin will be available in the community plugin browser in Obsidian after review. For a manual installation, you can download the necessary files and place them within your plugins folder.

---

## Support

If you like this Plugin and are considering donating to support continued development, use the button below!

Created with ❤️ by Chetachi