## 🚀 **Immich Power Tools** 0.11.0 ### Bug Fixes * adapt to vertical resolution and fix flickering ([8312fc1](https://github.com/varun-raj/immich-power-tools/commit/8312fc183db9a8e886da0cd0d901d52aab4a5d43)) * conflicts resolved ([a9038da](https://github.com/varun-raj/immich-power-tools/commit/a9038da6427a2c44b6bd277008c1488e356d4458)) * conflicts resolved ([ddbee4a](https://github.com/varun-raj/immich-power-tools/commit/ddbee4af03e29de95f983530f40ad8375296f8f9)) * conflicts resolved ([7266a2e](https://github.com/varun-raj/immich-power-tools/commit/7266a2edd689c9de21c782270f1e364aa8b9f8c6)) * convert to vertical resolution ([383b714](https://github.com/varun-raj/immich-power-tools/commit/383b71422056724a149e2f5e1e3c87c1c15dd89e)) * design fixes ([e305e45](https://github.com/varun-raj/immich-power-tools/commit/e305e458f1630c88dda3c0a7b3128a762f1f9e61)) * design fixes ([43cfcdb](https://github.com/varun-raj/immich-power-tools/commit/43cfcdbe8f8a568f2913e2a4146c802dd178100a)) * gemini key validation ([9f2f0ef](https://github.com/varun-raj/immich-power-tools/commit/9f2f0ef7a6cf124cc305dae5a9d08ecdd1ce43f8)) * minor design fix ([b365e7d](https://github.com/varun-raj/immich-power-tools/commit/b365e7d3ab2e23531c96425ded7afd5f27ad3cb6)) * thershold option and fix hide person ([e0f96ce](https://github.com/varun-raj/immich-power-tools/commit/e0f96cea0d3a978bb214c2a9caee52338e2e56a6)) ### Features * add logo screen at start ([7f359c1](https://github.com/varun-raj/immich-power-tools/commit/7f359c10d70a34ba792a5d121a838fb7f62b99c8)) * added google heatmap ([842e323](https://github.com/varun-raj/immich-power-tools/commit/842e323042d8a89f28776052efb51bfa127bf6e2)) * added preview in find ([31e5879](https://github.com/varun-raj/immich-power-tools/commit/31e58793beab20160f8f116b3c7cc109e2c4758f)) * added rewind data ([2b7dc94](https://github.com/varun-raj/immich-power-tools/commit/2b7dc94775dc4082e6d0c32ef0d22f3d267d61a6)) * base setup ([759d772](https://github.com/varun-raj/immich-power-tools/commit/759d7724237e3a59528026197f1e93680fdfa99d)) * base setup for search photos ([c0fec68](https://github.com/varun-raj/immich-power-tools/commit/c0fec68e434bff65eb11731f18dd85be19dce6e8)) * end of year release ([e4b7580](https://github.com/varun-raj/immich-power-tools/commit/e4b758018855d8dc5d5817b8589f92d38b89985a)) * end of year release ([bf301b9](https://github.com/varun-raj/immich-power-tools/commit/bf301b9c44745fd0b6c158d702381e8444278e23)) * end of year release ([c37c94f](https://github.com/varun-raj/immich-power-tools/commit/c37c94f1ec764eb50407c27f7ed3c56dc86d1aac)) * end of year release ([1f5202f](https://github.com/varun-raj/immich-power-tools/commit/1f5202f9b5d1126de17cc9f739511634a831de7e)) * end of year release ([a23aa88](https://github.com/varun-raj/immich-power-tools/commit/a23aa88ca481dff792d79f59c420b8038af5dd71)) * updated UI for rewind. ([37da0ed](https://github.com/varun-raj/immich-power-tools/commit/37da0ed69b930fec37d073a8cdfac93341503e43))
Immich Power Tools
A unofficial immich client to provide better tools to organize and manage your immich account. Building it to speed up your workflows in Immich to organize your people and albums.
💭 Back story
Recently I've migrated my entire Google photos library to Immich, I was able to successfully migrate all my assets along with its albums to immich. But there were few things like people match that was lacking. I loved Immich UI on the whole but for organizing content I felt its quite restricted and I had to do a lot of things in bulk instead of opening each asset and doing it. Hence I built this tool (continuing to itereate) to make my life and any other Immich user's life easier.
🚀 Getting Started
🐬 Using Docker
Power-tools is designed to be used alongside Immich, and there are two ways you can run it.
Method 1 - Docker Compose ( Recommended )
Add the following into your docker compose as a new service along side other immich services. Make sure you've power-tools in same network as immich.
See the sample docker-compose-all-immich.yml file for reference.
services:
# Other services...
power-tools:
container_name: immich_power_tools
image: ghcr.io/varun-raj/immich-power-tools:latest
ports:
- "8001:3000"
env_file:
- .env
Add the Immich API Key and immich url's to the env file (which you already have for the immich)
IMMICH_API_KEY= # your_immich_api_key
IMMICH_URL = "http://local-ip-of-immich:port" # Your immich instace ip address and port
EXTERNAL_IMMICH_URL = "https://external-address" # External address of immich
Refer here for obtaining Immich API Key: https://immich.app/docs/features/command-line-interface#obtain-the-api-key
Method 2 - Portainer
If you're using portainer, run the docker using docker run and add the power tools to the same network as immich.
docker run -d --name immich_power_tools -p 8001:3000 --env-file .env ghcr.io/varun-raj/immich-power-tools:latest
🚀 For local development
Note
Please use
bunto run the project. If you don't havebuninstalled, checkout bun.sh for installation.
Copy paste the .env.example to .env and fill in the values.
IMMICH_URL="" # Immich URL
IMMICH_API_KEY="" # Immich API Key
DB_USERNAME="" # Postgress Database Username
DB_PASSWORD = "" # Postgres Database Password
DB_HOST = "" # Postgres Host (IP address or hostname of the database)
DB_PORT = "" # Postgres Port number (Default: 5432)
DB_DATABASE_NAME = "" # Name of the database
Note
Make sure you have postgres port exposed on you machine.
Refer here for obtaining Immich API Key: https://immich.app/docs/features/command-line-interface#obtain-the-api-key
Run the development server:
bun run dev
Features
Immich Related
- Manage People
- Smart Merge
- Manage Albums
- Bulk Delete
- Bulk Edit
- Filters
- Potential Albums
- People in Album
- Missing Location
- Statistics
- EXIF Data
- Assets Overtime Chart
Tech Related
- Dark Mode
- Dockerize
- Authentication
- Push to github packages
Tech Stack
- Next.js for infrastructure
- Tailwind CSS for styling
- Shadcn for UI Components
- Axios for API calls
Contributing
Feel free to contribute to this project, I'm open to any suggestions and improvements. Please read the CONTRIBUTING.md for more details.
