Address Bar

Quick Access

When the mouse is hovering over the root node or clicking other expansion buttons, the quick access menu is opened (The trigger conditions can be adjusted at Preferences > Habits > Expand Segment Path)


Click the blank space on the right side of the Address Bar or press ⌘+L to enter the address editing mode. When you manually enter the location, it supports Auto Completion.

Quick Launch

In order to cooperate with other applications to improve your work efficiency, you can configure QSpace to launch an application or service with One-click, and you can pass the current selections to the program to be launched.

Settings entrance: QSpace Preferences > Quick Launch.


Configure one-click start Terminal, support system Terminal and iTerm. And you can setup a hotkey.


Configure one-click start Editor, support VSCode, Sublime, MacVim and other popular editors. The default hotkey is ⌘+E.

Application & Service

Configure one-click launch of applications or services. You can set startup parameters (different from application), open files, and support passing QSpace related parameters.

$selections // The selected files in current view.
$workspace_root // The root location of current view.
$selections_or_root // The selected files, or the root of current view if no selections.
$stash_items // Items on the Stash Shelf.

New Files

Creating new files setup entrance: QSpace Preferences > New File.

If you want to create a new file type, add the corresponding file name to the New File list.

File Template

If you want to create a new file, use a template instead of creating an empty file. You can click the .. button to the right of the file name to select the file as template.

File Name Variables

The file name support date variables $date(format) when creating a new file, where the format is a standard date formatter.

y2008Year, no padding
yy08Year, two digits (padding with a zero if necessary)
yyyy2008Year, minimum of four digits (padding with zeros if necessary)
Q4The quarter of the year. Use QQ if you want zero padding.
QQQQ4Quarter including "Q"
QQQQ4th quarterQuarter spelled out
M12The numeric month of the year. A single M will use '1' for January.
MM12The numeric month of the year. A double M will use '01' for January.
MMMDecThe shorthand name of the month
MMMMDecemberFull name of the month
MMMMMDNarrow name of the month
d14The day of the month. A single d will use 1 for January 1st.
dd14The day of the month. A double d will use 01 for January 1st.
EEEETuesdayThe wide name of the day of the week
EEEEETThe narrow day of week
EEEEEETuThe short day of week
h4The 12-hour hour.
hh04The 12-hour hour padding with a zero if there is only 1 digit
H16The 24-hour hour.
HH16The 24-hour hour padding with a zero if there is only 1 digit.
aPMAM / PM for 12-hour time formats
m35The minute, with no padding for zeroes.
mm35The minute with zero padding.
s8The seconds, with no padding for zeroes.
ss08The seconds with zero padding.
SSS123The milliseconds.
For the full reference of available format options, see Unicode Technical Reference #35.


[Weekly] $date(yyyy-QQQ MM/dd EEEEEE).docx
When creating a new file, the output file name is: [Weekly] 2020-Q3 08/24 Mo.docx


Windows Style

Enter Open

Delete Go Back

Forward Delete Delete

macOS Style

Enter Rename

Action Target

Pasting items or creating new folders into Workspace Root Directory or Current Selected Folder.

Drag Shaking Gesture

Call out the Floating Stash Shelf.

Auto Hide Stash Shelf

Hide the Floating Stash Shelf, if it has been emptied.

Double Click on Blank

Go enclosing folder.

Batch Rename Mode

When you select multiple items to rename, you can start from Simple or Advanced mode.

Keep List View Expanded

When changed the location, try to keep the folder expanded status.

Mark Cutting Files

When cutting items (⌘+X) through QSpace, mark them.

Active Folders

After it is turned on, it will automatically synchronize the alias of the folder that QSpace is accessing in the active folder. You can drag the Active Folder to Favorites in Finder Sidebar. In order to quickly select the folder that QSpace is accessing in the Open Panel and Save Panel of other applications.


Customize Context Menu

QSpace Preferences > Context Menu

Customize Hotkeys

QSpace Preferences > Hotkeys

Customize Toolbar

Menu > View > Customize Toolbar...

Customize Touch Bar

Menu > View > Customize Touch Bar...

Enhanced Archiver

This extension is an IAP item, it's free for now! (The price may be adjusted, subject to the actual purchase price).

Create Archive

Save Location
Same folder as files (by default), you can manually specify a fixed location.

Trim original extension when archiving single file
On by default. For instance: sample.jpg will compress to

ZIPby default, 7Z. 7Z format support Solid Compress option.

Add a password to encrypt the archive, 7Z format also can Encrypt the file names.

Split as Volumes
You can split the archive to multiple volumes.

Ignore Items
Temporaries ( such as .DS_Store、__MACOSX), Hiddens, .git folders, .svnfolders.

After Archiving
Leave files alone (by default) or Move files to trash.

Open Archive

Support File Types
zip, rar, 7z, gz, gzip, tgz, tar, gtar, tbz2, bz2, bzip2, txz, xz, z, lzma, lz, z01, 001, r01. Click to edit, only handle archives with specific extensions.

Open With
QSpace(by default) or Default Application.

Remember Passwords
Runtime(Only remember passwords on runtime, restart QSpace need re-enter), Always, Never.

Expandable Directly in
Columns View (On by default, you can expand archives in Columns View), List View(Off by default, you can open and browse archives directly. If turn on, you can expand archives directly in List View).

Ignore Items
Temporaries ( such as .DS_Store、__MACOSX), Hiddens, .git folders, .svnfolders.

Server Connections

This extension is an IAP item, reference price: 0.99$ (The price may be adjusted, subject to the actual purchase price).

Connect to servers and currently support SFTP, FTP/FTPS, Amazon S3, Aliyun OSS, WebDAV/WebDAV HTTPS, SMB, AFP, NFS network protocols, and connect to OneDrive .

Similar to the operation experience of local files, you can drag and drop items between "local" and "remote", "remote" and "remote" to easily copy and move files everywhere.

Stash Shelf

This extension is an IAP item, reference price: 0.99$ (The price may be adjusted, subject to the actual purchase price).

Multiple Source

You can drag and drop Local Files, Remote Files, Web Images or read files, text or images from the Clipboard to the Stash Shelf.

Unified Action

Open, Copy, Rename, Quick Look, Share, Cut, Copy, and Run Services.


During dragging, shake left and right to call outFloating Stash Shelf.


Support Quick Launch variable $stash_items.

Advanced Batch Rename

This extension is an IAP item, reference price: 0.99$ (The price may be adjusted, subject to the actual purchase price).

Instant Preview

After changing the rules, you can immediately see the renaming results.


You can directly enter or drag and drop information elements into the Format input box.

Basic Elements: File Name , Serial Number , Folder

Date Elements: Year , Month , Day , Day of Week , Hour , Minute , Second , AM/PM , Millisecond.

Music Elements: Authors , Title , Album , Track Number.

Image Elements: Width , Height , Camera Make , Camera Model , Longitude , Latitude , Altitude.

If an element of the file is empty, you can set it to a fixed value or choose to skip it.

Serial Number

You can set the Length, Starts and Step of the Serial Number.


Select the specific date of the Date Elements: Now, File Modified, File Added or File Created.

Name Processors (File Name / Formatted Name)

Support multiple text Adding, Replacing and Removing on original File Name or Formatted Name, also support regular expression options.

Save Preset

Support saving and loading preset renaming rules.

Automatic Logging

Each batch renaming will automatically record the log for review of the past.

How to upgrade to QSpace Pro from QSpace?

① Obtain the [QSpace Pro] extension

Obtain the [QSpace Pro]extension from QSpace extensions page.

② Bind your email address

Click "Binding" on the QSpace extensions page, and binding your email address for login QSpace Pro.

③ Download & install QSpace Pro

Download and install QSpace Pro from Official Website.

④ Login QSpace Pro

Login QSpace Pro with your email address.

* You need binding your email address in QSpace first, then login QSpace Pro. If you have logined before binding, you can try to relogin.
* You can click the "..." button at the left bottom of QSpace Preferences to export & import your settings.

How to show hidden files?


Press ⌘ + shift + . to switch the display of hidden files.

Toolbar Switch

Click the Menu Bar > View > Customize Toolbar... to enter the Toolbar editing mode, drag Show Hidden Files into the Toolbar, you can switch the hidden file through this switch.

Touch Bar Switch

Click the Menu Bar > View > Customize Touch Bar... to enter the Touch Bar editing mode, drag Show Hidden Files into Touch Bar, you can switch the hidden file through this switch.

Context Menu Item

QSpace Preferences > Context Menu , enable the Show Hidden Files item.

How to keep hidden files visible all the time?

In order to protect privacy, the visibility of hidden files in QSpace is limited to current workspace, and the visibility of hidden files is automatically closed when the workspace is reopened. If you want to keep the hidden files visible all the time, you can check the Keep Hidden Visible on QSpace Preferences > Habits.

How to authorize QSpace to manage files?

Due to Apple's sandbox restrictions, QSpace requires user authorization before accessing any file.


QSpace Preferences > Permissions


After clicking the All Files button, then click the Authorize button on the pop-up window to manage all files through QSpace.

Due to macOS's security policy restrictions, if you want to access some privacy folders such as the Desktop folders, Trash folders, etc., you need to authorize all files then grant Full Disk Access Permission.

Access Restrictions

If All Files are authorized and Full Disk Access is enabled, most files can be managed through QSpace. However, some files that require administrator permission to access (for example, applications downloaded from the AppStore, some read-only folders, and folders such as "recovered files" caused by system upgrades) can only be managed through Finder.

How to open archives from Finder using QSpace?

Follow the steps below to set QSpace as the default application for a certain type of archive (such as zip). Then when you open the archive from Finder, you can browse it directly through QSpace.

How to hide the QSpace icon on the system Status Bar?

On the bottom of QSpace Preferences > Habits

Use Status bar App IconStatus bar Workspace to toggle visibility of the QSpace icon and opened workspace names.

More Habits Settings

How to setup Windows key pressing style?

QSpace Preferences > Habits

Click the Windows Style button, then you are on Windows!

More Habits Settings

How to go to enclosing folder when double clicking the blank space?

QSpace Preferences > Habits

Check "Double Click on Blank"Go to Enclosing Folder.

More Habits Settings

How to replace Finder with QSpace?

"Reveal in Finder" open QSpace replacing of Finder

If you are using QSpace Pro, just go to Preferences > Open Mode > "Reveal in Finder" with, choose "QSpace Pro". (Restart the apps to take effect)

If you are using QSpace MAS, open the Terminal, enter the following command and press Enter then restart the apps to take effect:

defaults write -g NSFileViewer -string com.jinghaoshe.qspace;

defaults write LSHandlers -array-add '{LSHandlerContentType="public.folder";LSHandlerRoleAll="com.jinghaoshe.qspace";}'

If you want to cancel the settings, open the Terminal, enter the following command and press Enter then restart the system:

defaults delete -g NSFileViewer;

defaults write LSHandlers -array-add '{LSHandlerContentType="public.folder";LSHandlerRoleAll="";}'

Start QSpace from Terminal

Use the open command with -a QSpace , for easy input you can make an alias for open -a QSpace.

E.g, alias qs='open -a QSpace'. When you enter qs , it means open -a QSpace , and the other parameters are the same with open.

If you want the alias always work, just append the alias qs='open -a QSpace' to ~/.bash_profile. (if the file ~/.bash_profile does not exists, create one).

Tips: If you are using QSpace Pro, you need to replace QSpace with QSpace\ Pro.

How to open Desktop folders with QSpace?

From Context Menu > Services > Reveal in QSpace

Using Hotkey

Go to System Preferences > Keyboard > Shortcuts > Services. ChooseReveal in QSpace, add a custom shortcut key. Press the shortcut key on Desktop or Finder to open the selected folder with QSpace.

How to show the progress of file operations?

Task Status on Toolbar

When copying, moving or compressing files, the progress will be displayed on the Task Status in Toolbar. Click the Task Status to expand the detailed task list, view and cancel tasks.

Application Badges

When copying, moving or compressing files, the progress will be displayed on the Application Badges (Logo).

How to open fixed folders every time opening the workspace?

Click Set as Start Location on Context Menu. Every view can set it's own Start Location

How to set language for QSpace?

Open the system Preferences > Language & Region > Apps, add , then you can choose language for QSpace.

This setting needs macOS 10.15 (Catalina) or above.


If none of the above instructions can solve your problem, please contact the developer in the following ways:

QQ Group: QSpace Group