vxavictor513 · June 17, 2025 07:35 · Jun 17, 2025 · Mar 19, 2025 · Feb 28, 2025 · Feb 27, 2025
diff --git a/macos-setup.md b/macos-setup.md
@@ -29,6 +29,7 @@
 - [ ] Screenshot - https://shottr.cc/
 - [ ] https://apps.apple.com/us/app/amphetamine/id937984704
 - [ ] https://github.com/jordanbaird/Ice or https://github.com/dwarvesf/hidden
+- [ ] https://obsproject.com/
 
 #### Backend Development
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -16,6 +16,8 @@
 - [ ] exa, a modern replacement for ‘ls’, https://github.com/eza-community/eza
 - [ ] tldr, collaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr
 - [ ] dive, a tool for exploring each layer in a docker image, https://github.com/wagoodman/dive
+- [ ] bat, A cat(1) clone with wings, https://github.com/sharkdp/bat
+- [ ] hyperfine, A command-line benchmarking tool, https://github.com/sharkdp/hyperfine
 
 #### General
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -190,3 +190,17 @@ Consider doing the following:
 1. Apply the changes and restart IntelliJ IDEA if necessary.
 
 Ref: https://github.com/mapstruct/mapstruct/issues/2802
+
+### Protobuf: Cannot compile on Apple Silicon machines
+
+On Apple Silicon machines, when building the application using Maven command, we always needed to specify `-Dos.arch=x86_64` otherwise the Protobuf could not be successfully compiled.
+
+An alternative is to specify the Protobuf version in the Maven plugin configuration.
+
+```xml
+<configuration>
+    <protocVersion>${protoc.version}</protocVersion>
+</configuration>
+```
+
+Ref: https://github.com/os72/protoc-jar-maven-plugin/issues/129
diff --git a/macos-setup.md b/macos-setup.md
@@ -178,3 +178,15 @@ mysqladmin -u root -p'password' password ''
 ```
 
 Ref: https://serverfault.com/questions/103412/how-to-change-my-mysql-root-password-back-to-empty
+
+### MapStruct: Delegate IDE build/run actions to Maven in IntelliJ
+
+Sometimes local build in IntelliJ does not work when a Java project has MapStruct.
+
+Consider doing the following:
+
+1. Navigate to: `File > Settings > Build, Execution, Deployment > Build Tools > Maven > Runner`
+1. Check the option: `Delegate IDE build/run actions to Maven`
+1. Apply the changes and restart IntelliJ IDEA if necessary.
+
+Ref: https://github.com/mapstruct/mapstruct/issues/2802
diff --git a/macos-setup.md b/macos-setup.md
@@ -156,7 +156,7 @@ docker rm tmp_$$
 docker ps -a
 ```
 
-### Homebrew MySQL
+### MySQL: MySQL 9 fails to start
 
 There is a known issue at [Homebrew#5539](https://github.com/orgs/Homebrew/discussions/5539Reinstall) where the introduction of MySQL 9 causing the database fails to start.
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -170,3 +170,11 @@ When troubleshooting, try the steps mentioned in `brew info mysql`
    - brew services stop [email protected]
    - brew services start mysql
   ```
+
+### MySQL: Reset password to empty string
+
+```
+mysqladmin -u root -p'password' password ''
+```
+
+Ref: https://serverfault.com/questions/103412/how-to-change-my-mysql-root-password-back-to-empty
diff --git a/macos-setup.md b/macos-setup.md
@@ -155,3 +155,18 @@ docker stop tmp_$$
 docker rm tmp_$$
 docker ps -a
 ```
+
+### Homebrew MySQL
+
+There is a known issue at [Homebrew#5539](https://github.com/orgs/Homebrew/discussions/5539Reinstall) where the introduction of MySQL 9 causing the database fails to start.
+
+When troubleshooting, try the steps mentioned in `brew info mysql`
+
+  ```
+  Upgrading from MySQL <8.4 to MySQL >9.0 requires running MySQL 8.4 first:
+   - brew services stop mysql
+   - brew install [email protected]
+   - brew services start [email protected]
+   - brew services stop [email protected]
+   - brew services start mysql
+  ```
diff --git a/macos-setup.md b/macos-setup.md
@@ -153,4 +153,5 @@ tar -xvf output.tar
 # Clean up
 docker stop tmp_$$
 docker rm tmp_$$
+docker ps -a
 ```
diff --git a/macos-setup.md b/macos-setup.md
@@ -146,7 +146,11 @@ export DOCKER_HOST=$(docker context inspect -f '{{ .Endpoints.docker.Host }}')
 See https://stackoverflow.com/a/53481010
 
 ```sh
+# Create
 docker create --name="tmp_$$" image:tag
 docker export tmp_$$ > output.tar
 tar -xvf output.tar
+# Clean up
+docker stop tmp_$$
+docker rm tmp_$$
 ```
diff --git a/macos-setup.md b/macos-setup.md
@@ -140,3 +140,13 @@ See https://github.com/wagoodman/dive/issues/462#issuecomment-1751187322
 ```sh
 export DOCKER_HOST=$(docker context inspect -f '{{ .Endpoints.docker.Host }}')
 ```
+
+### How to inspect files in a container image without running it
+
+See https://stackoverflow.com/a/53481010
+
+```sh
+docker create --name="tmp_$$" image:tag
+docker export tmp_$$ > output.tar
+tar -xvf output.tar
+```
diff --git a/macos-setup.md b/macos-setup.md
@@ -132,3 +132,11 @@ docker buildx version
 #### Adding insecure registries to Colima
 
 See official docs [here](https://github.com/abiosoft/colima/blob/main/docs/FAQ.md#how-to-customize-docker-config-eg-add-insecure-registries).
+
+#### Using Dive with Colima
+
+See https://github.com/wagoodman/dive/issues/462#issuecomment-1751187322
+
+```sh
+export DOCKER_HOST=$(docker context inspect -f '{{ .Endpoints.docker.Host }}')
+```
diff --git a/macos-setup.md b/macos-setup.md
@@ -14,7 +14,8 @@
 - [ ] rga, like ripgrep, but also search in PDFs, E-Books, Office documents, zip, tar.gz, etc., https://github.com/phiresky/ripgrep-all
 - [ ] fd, an alternative to 'find', https://github.com/sharkdp/fd
 - [ ] exa, a modern replacement for ‘ls’, https://github.com/eza-community/eza
-- [ ] tldr, aollaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr
+- [ ] tldr, collaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr
+- [ ] dive, a tool for exploring each layer in a docker image, https://github.com/wagoodman/dive
 
 #### General
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -104,6 +104,8 @@ Ref: https://github.com/derailed/k9s/issues/780
 
 ### Docker Setup
 
+#### Colima as Docker Daemon
+
 In case Docker Desktop cannot be used (e.g. due to licence limitation), can consider using [Colima](https://github.com/abiosoft/colima) to replace Docker Daemon, then Docker CLI can still be used.
 
 Sample command to start Colima

diff --git a/macos-setup.md b/macos-setup.md
@@ -112,7 +112,9 @@ Sample command to start Colima
 colima start --cpu 4 --memory 8 --disk 100
 ```
 
-Install Docker `buildx` for Colima (See discussion [colima#273](https://github.com/abiosoft/colima/discussions/273))
+#### Install Docker `buildx` for Colima
+
+See official doc [here](https://github.com/abiosoft/colima/blob/main/docs/FAQ.md#docker-buildx-plugin-is-missing) or discussion [colima#273](https://github.com/abiosoft/colima/discussions/273)
 
 ```sh
 brew install docker-buildx
@@ -123,3 +125,7 @@ ln -s $(which docker-buildx) ~/.docker/cli-plugins/docker-buildx
 colima restart
 docker buildx version
 ```
+
+#### Adding insecure registries to Colima
+
+See official docs [here](https://github.com/abiosoft/colima/blob/main/docs/FAQ.md#how-to-customize-docker-config-eg-add-insecure-registries).
diff --git a/macos-setup.md b/macos-setup.md
@@ -110,4 +110,16 @@ Sample command to start Colima
 
 ```sh
 colima start --cpu 4 --memory 8 --disk 100
-```
+```
+
+Install Docker `buildx` for Colima (See discussion [colima#273](https://github.com/abiosoft/colima/discussions/273))
+
+```sh
+brew install docker-buildx
+
+mkdir -p ~/.docker/cli-plugins
+ln -s $(which docker-buildx) ~/.docker/cli-plugins/docker-buildx
+
+colima restart
+docker buildx version
+```
diff --git a/macos-setup.md b/macos-setup.md
@@ -105,3 +105,9 @@ Ref: https://github.com/derailed/k9s/issues/780
 ### Docker Setup
 
 In case Docker Desktop cannot be used (e.g. due to licence limitation), can consider using [Colima](https://github.com/abiosoft/colima) to replace Docker Daemon, then Docker CLI can still be used.
+
+Sample command to start Colima
+
+```sh
+colima start --cpu 4 --memory 8 --disk 100
+```
diff --git a/macos-setup.md b/macos-setup.md
@@ -104,4 +104,4 @@ Ref: https://github.com/derailed/k9s/issues/780
 
 ### Docker Setup
 
-In case Docker Desktop cannot be used (e.g. due to licence limitation), can consider using [Colima]([url](https://github.com/abiosoft/colima)) to replace Docker Daemon, then Docker CLI can still be used.
+In case Docker Desktop cannot be used (e.g. due to licence limitation), can consider using [Colima](https://github.com/abiosoft/colima) to replace Docker Daemon, then Docker CLI can still be used.
diff --git a/macos-setup.md b/macos-setup.md
@@ -101,3 +101,7 @@ This happens when k9s is installed via Homebrew, where Cgo is disabled by defaul
 To overcome this, we can compile and install k9s from source using `go install`.
 
 Ref: https://github.com/derailed/k9s/issues/780
+
+### Docker Setup
+
+In case Docker Desktop cannot be used (e.g. due to licence limitation), can consider using [Colima]([url](https://github.com/abiosoft/colima)) to replace Docker Daemon, then Docker CLI can still be used.
diff --git a/macos-setup.md b/macos-setup.md
@@ -11,7 +11,7 @@
 - [ ] https://brew.sh/
 - [ ] fzf, a command-line fuzzy finder, https://github.com/junegunn/fzf
 - [ ] ripgrep, recursively searches directories for a regex pattern while respecting your gitignore, https://github.com/BurntSushi/ripgrep
-- [ ] rga, ripgrep, but also search in PDFs, E-Books, Office documents, zip, tar.gz, etc., https://github.com/phiresky/ripgrep-all
+- [ ] rga, like ripgrep, but also search in PDFs, E-Books, Office documents, zip, tar.gz, etc., https://github.com/phiresky/ripgrep-all
 - [ ] fd, an alternative to 'find', https://github.com/sharkdp/fd
 - [ ] exa, a modern replacement for ‘ls’, https://github.com/eza-community/eza
 - [ ] tldr, aollaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr

diff --git a/macos-setup.md b/macos-setup.md
@@ -11,6 +11,7 @@
 - [ ] https://brew.sh/
 - [ ] fzf, a command-line fuzzy finder, https://github.com/junegunn/fzf
 - [ ] ripgrep, recursively searches directories for a regex pattern while respecting your gitignore, https://github.com/BurntSushi/ripgrep
+- [ ] rga, ripgrep, but also search in PDFs, E-Books, Office documents, zip, tar.gz, etc., https://github.com/phiresky/ripgrep-all
 - [ ] fd, an alternative to 'find', https://github.com/sharkdp/fd
 - [ ] exa, a modern replacement for ‘ls’, https://github.com/eza-community/eza
 - [ ] tldr, aollaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr

diff --git a/macos-setup.md b/macos-setup.md
@@ -12,7 +12,8 @@
 - [ ] fzf, a command-line fuzzy finder, https://github.com/junegunn/fzf
 - [ ] ripgrep, recursively searches directories for a regex pattern while respecting your gitignore, https://github.com/BurntSushi/ripgrep
 - [ ] fd, an alternative to 'find', https://github.com/sharkdp/fd
-- [ ] exa, a modern replacement for ‘ls’, https://github.com/ogham/exa
+- [ ] exa, a modern replacement for ‘ls’, https://github.com/eza-community/eza
+- [ ] tldr, aollaborative cheatsheets for console commands, https://github.com/tldr-pages/tldr
 
 #### General
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -9,7 +9,10 @@
 - [ ] https://iterm2.com/
 - [ ] https://ohmyz.sh/
 - [ ] https://brew.sh/
-- [ ] https://github.com/junegunn/fzf
+- [ ] fzf, a command-line fuzzy finder, https://github.com/junegunn/fzf
+- [ ] ripgrep, recursively searches directories for a regex pattern while respecting your gitignore, https://github.com/BurntSushi/ripgrep
+- [ ] fd, an alternative to 'find', https://github.com/sharkdp/fd
+- [ ] exa, a modern replacement for ‘ls’, https://github.com/ogham/exa
 
 #### General
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -37,6 +37,7 @@
 - [ ] Dropzone 4 - https://aptonic.com/ 
 - [ ] Screenshot - https://cleanshot.com/ 
 - [ ] Alt Tab - https://alt-tab-macos.netlify.app/
+- [ ] Raindrop.io - https://raindrop.io/
 
 ## Productivity Notes
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -20,6 +20,7 @@
 - [ ] https://github.com/Ji4n1ng/OpenInTerminal
 - [ ] Screenshot - https://shottr.cc/
 - [ ] https://apps.apple.com/us/app/amphetamine/id937984704
+- [ ] https://github.com/jordanbaird/Ice or https://github.com/dwarvesf/hidden
 
 #### Backend Development
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -4,16 +4,20 @@
 
 ### What I use
 
-#### General
+#### Command-line Tools
 
+- [ ] https://iterm2.com/
+- [ ] https://ohmyz.sh/
 - [ ] https://brew.sh/
+- [ ] https://github.com/junegunn/fzf
+
+#### General
+
 - [ ] https://www.alfredapp.com/
-- [ ] https://iterm2.com/
 - [ ] https://rectangleapp.com/
 - [ ] https://freemacsoft.net/appcleaner/
 - [ ] https://pilotmoon.com/scrollreverser/
 - [ ] https://github.com/Ji4n1ng/OpenInTerminal
-- [ ] https://ohmyz.sh/
 - [ ] Screenshot - https://shottr.cc/
 - [ ] https://apps.apple.com/us/app/amphetamine/id937984704
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -81,7 +81,7 @@ idea .
 
 Ref: https://stackoverflow.com/a/49819015/5366727
 
-### k9s cannot resolve host name through VPN
+### Known Issue: k9s cannot resolve host name through VPN
 
 When connected to VPN, k9s might not be able to resolve private host names.
 

diff --git a/macos-setup.md b/macos-setup.md
@@ -80,3 +80,13 @@ idea .
 ```
 
 Ref: https://stackoverflow.com/a/49819015/5366727
+
+### k9s cannot resolve host name through VPN
+
+When connected to VPN, k9s might not be able to resolve private host names.
+
+This happens when k9s is installed via Homebrew, where Cgo is disabled by default.
+
+To overcome this, we can compile and install k9s from source using `go install`.
+
+Ref: https://github.com/derailed/k9s/issues/780
diff --git a/macos-setup.md b/macos-setup.md
@@ -4,6 +4,9 @@
 
 ### What I use
 
+#### General
+
+- [ ] https://brew.sh/
 - [ ] https://www.alfredapp.com/
 - [ ] https://iterm2.com/
 - [ ] https://rectangleapp.com/
@@ -12,6 +15,11 @@
 - [ ] https://github.com/Ji4n1ng/OpenInTerminal
 - [ ] https://ohmyz.sh/
 - [ ] Screenshot - https://shottr.cc/
+- [ ] https://apps.apple.com/us/app/amphetamine/id937984704
+
+#### Backend Development
+
+- [ ] https://github.com/derailed/k9s
 
 ### Other Recommendations
 
@@ -25,6 +33,14 @@
 - [ ] Screenshot - https://cleanshot.com/ 
 - [ ] Alt Tab - https://alt-tab-macos.netlify.app/
 
+## Productivity Notes
+
+### Shortcut for Screenshot
+
+`Command + Control + Shift + 4` to snap, at the same time copy.
+
+Read more [here](https://www.ias.edu/itg/content/keyboard-shortcuts-capture-screen-shot-mac-os-x).
+
 ### Make app switcher displays on both multiple screens
 
 ```shell
@@ -52,3 +68,15 @@ xed .
 ```
 
 Ref: https://stackoverflow.com/a/52739630/5366727
+
+### Open project in IntelliJ from command line
+
+In IntelliJ, go to `Tools > Create Commandline Launcher` for one-time setup.
+
+At the directory where your Java project is, run the following command.
+
+```shell
+idea .
+```
+
+Ref: https://stackoverflow.com/a/49819015/5366727
diff --git a/macos-setup.md b/macos-setup.md
@@ -11,15 +11,15 @@
 - [ ] https://pilotmoon.com/scrollreverser/
 - [ ] https://github.com/Ji4n1ng/OpenInTerminal
 - [ ] https://ohmyz.sh/
+- [ ] Screenshot - https://shottr.cc/
 
 ### Other Recommendations
 
 - [ ] https://github.com/gao-sun/eul
 - [ ] https://github.com/MonitorControl/MonitorControl#readme
 - [ ] Equalizer - https://eqmac.app/ 
 - [ ] https://apps.apple.com/us/app/otp-manager/id928941247
-- [ ] https://hyper.is/
-- [ ] Screenshot - https://shottr.cc/ 
+- [ ] https://hyper.is/ 
 - [ ] Calculator - https://numi.app/
 - [ ] Dropzone 4 - https://aptonic.com/ 
 - [ ] Screenshot - https://cleanshot.com/ 

diff --git a/macos-setup.md b/macos-setup.md
@@ -42,3 +42,13 @@ sudo spctl --master-enable # re-enable
 ```
 
 Ref: https://osxdaily.com/2015/05/04/disable-gatekeeper-command-line-mac-osx/
+
+### Open project in Xcode from command line
+
+At the directory where your `xcworkspace` or `xcodeproj` is, run the following command.
+
+```shell
+xed .
+```
+
+Ref: https://stackoverflow.com/a/52739630/5366727