Command line tool ignores paths with ( ) round brackets #7356

Open
opened 2026-02-20 05:02:21 -05:00 by deekerman · 2 comments
Owner

Originally created by @brochchris on GitHub (Nov 14, 2025).

I have searched the existing issues, both open and closed, to make sure this is not a duplicate report.

  • Yes

The bug

When I use the command line tool to upload albums, folders with ( ) round brackets are not crawled and no uploads are done.

Example:
immich upload --album soccer\ pics\ A
should upload photos from folder "soccer pics (A)", but reports:
Crawling for assets...
No files found, exiting

All other folders (also with blank spaces etc.) work fine.

The OS that Immich Server is running on

raspberry pi 5

Version of Immich Server

v2.2.3

Version of Immich Mobile App

v2.2.3

Platform with the issue

  • Server
  • Web
  • Mobile

Device make and model

MacOS 14

Your docker-compose.yml content

standard

Your .env content

standard

Reproduction steps

  1. install command line tool
  2. use immich command line tool to upload folder with photos
  3. no assets are uploaded
    ...

Relevant log output


Additional information

No response

Originally created by @brochchris on GitHub (Nov 14, 2025). ### I have searched the existing issues, both open and closed, to make sure this is not a duplicate report. - [x] Yes ### The bug When I use the command line tool to upload albums, folders with ( ) round brackets are not crawled and no uploads are done. Example: immich upload --album soccer\ pics\ \(A\) should upload photos from folder "soccer pics (A)", but reports: Crawling for assets... No files found, exiting All other folders (also with blank spaces etc.) work fine. ### The OS that Immich Server is running on raspberry pi 5 ### Version of Immich Server v2.2.3 ### Version of Immich Mobile App v2.2.3 ### Platform with the issue - [x] Server - [ ] Web - [ ] Mobile ### Device make and model MacOS 14 ### Your docker-compose.yml content ```YAML standard ``` ### Your .env content ```Shell standard ``` ### Reproduction steps 1. install command line tool 2. use immich command line tool to upload folder with photos 3. no assets are uploaded ... ### Relevant log output ```shell ``` ### Additional information _No response_
Author
Owner

@meesfrensel commented on GitHub (Nov 20, 2025):

Hi, I'm guessing you have to escape the parentheses:

no:
immich upload --album soccer\ pics\ (A)
yes:
immich upload --album soccer\ pics\ \(A\)
or:
immich upload --album "soccer pics (A)"

haven't tested this.

@meesfrensel commented on GitHub (Nov 20, 2025): Hi, I'm guessing you have to escape the parentheses: ``` no: immich upload --album soccer\ pics\ (A) yes: immich upload --album soccer\ pics\ \(A\) or: immich upload --album "soccer pics (A)" ``` haven't tested this.
Author
Owner

@brochchris commented on GitHub (Dec 2, 2025):

Thanks for the response, but unfortunately, none of the alternatives work. I use a workaround: change the folder name to a name without parentheses, upload it, an change the album name in immich.

@brochchris commented on GitHub (Dec 2, 2025): Thanks for the response, but unfortunately, none of the alternatives work. I use a workaround: change the folder name to a name without parentheses, upload it, an change the album name in immich.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/immich#7356
No description provided.