password_manager(Offline-capable) installation

中文 | English | 使用说明

## 📌 中文

展开/折叠

Password Manager 是一个安全的密码存储和管理工具。

📌 主要功能：

✅ 安全存储密码
✅ AES 加密保护数据
✅ 命令行管理密码 ✅ 备份数据

---

🚀 安装方法（Mac & Windows & linux）

1. 你可以将编译后的 pm 文件获取到本地电脑，并将其添加到环境变量，以便在命令行中随时使用。
2. 将整个项目克隆到本地后，进入项目目录，运行 go build -o pm 命令来编译 Golang 程序，生成可执行文件，并将其路径添加到环境变量，以便在命令行中随时使用。（推荐）

---

💻 MacOS 安装

1. 克隆仓库到本地

   git clone https://github.com/mike120200/terminal-password-manager.git

2. 编译golang程序生成可执行文件

   go build -o pm

3. 创建pm_dir目录（其他命名也可，配置环境变量的时候对应上即可）

   mkdir pm_dir

4. 将pm移动至pm_dir

5. 配置环境变量

   • 设置 Zsh 终端的环境变量，path替换成真实的路径

     echo 'export PATH="/path/pm_dir:$PATH"' >> ~/.zshrc
     source ~/.zshrc

   • 设置bash环境变量，path替换成真实的路径

     echo 'export PATH="/path/pm_dir:$PATH"' >> ~/.bash_profile
     source ~/.bash_profile

6. 检查是否安装成功

   pm --help

💻 Linux安装

1. 克隆仓库到本地

   git clone https://github.com/mike120200/terminal-password-manager.git

2. 编译golang程序生成可执行文件

   go build -o pm

3. 创建pm_dir目录（其他命名也可，配置环境变量的时候对应上即可）

   mkdir pm_dir

4. 将pm移动至pm_dir

5. 配置环境变量

   • 将以下export PATH="/path/pm_dir:$PATH"放到对应的操作系统的配置文件里面

     echo 'export PATH="/path/pm_dir:$PATH"' >> /etc/profile
     source /etc/profile

6. 检查是否安装成功

   pm --help

🖥️ Windows 安装

1. 克隆仓库到本地

   git clone https://github.com/mike120200/terminal-password-manager.git

2. 编译golang程序生成可执行文件

   go build -o pm

3. 创建 pm_dir 文件夹（其他命名也可，配置环境变量的时候对应上即可）

4. 将pm.exe移动至pm_dir

5. 配置环境变量

   • 打开 控制面板 → 系统 → 高级系统设置 → 环境变量
   • 在 系统变量 或 用户变量 里找到 Path
   • 点击 编辑，新增 文件夹pm_dir的绝对路径
   • 保存后重启 CMD

6. 检查是否安装成功

   pm --help

---

📌 English

Expand/Collapse

Password Manager is a secure password storage and management tool.

📌 Main Features:

✅ Securely store passwords ✅ AES encryption for data protection ✅ Manage passwords via the command line ✅ Backup stored data

🚀 Installation Guide (Mac & Windows)

1. You can download the compiled pm executable file to your local computer and add it to the system environment variables for convenient command-line usage.
2. After cloning the entire project to your local machine, navigate into the project directory and execute the go build -o pm command to compile the Golang program, generating an executable file. Then, add its path to your environment variables to make it readily available for use from the command line at any time. (Recommended)

💻 MacOS Installation

1. Clone the repository to your local machine

   git clone https://github.com/mike120200/terminal-password-manager.git

2. Compile the Golang program to generate an executable file

   go build -o pm

3. Create a pm_dir directory (you can use any name, just ensure it matches in the environment variable configuration)

   mkdir pm_dir  

4. Move pm into pm_dir

5. Configure environment variables

   • For Zsh terminal*, replace path with th*e actual directory path

     echo 'export PATH="/path/pm_dir:$PATH"' >> ~/.zshrc  
     source ~/.zshrc 

   • For Bash terminal, replace path with the actual directory path

     echo 'export PATH="/path/pm_dir:$PATH"' >> ~/.bash_profile  
     source ~/.bash_profile 

6. Verify Installation

   pm --help 

💻 Linux Installation

1. Clone the repository to your local machine

   git clone https://github.com/mike120200/terminal-password-manager.git

2. Compile the Golang program to generate an executable file

   go build -o pm

3. Create a pm_dir folder (you can use any name, just ensure it matches in the environment variable configuration)

4. Move pm into pm_dir

5. Configure environment variables

   • Place the following export PATH="/path/pm_dir:$PATH" into the corresponding operating system's configuration file.

     echo 'export PATH="/path/pm_dir:$PATH"' >> /etc/profile
     source /etc/profile

6. Verify Installation

   pm --help 

🖥️ Windows Installation

1. Clone the repository to your local machine

   git clone https://github.com/mike120200/terminal-password-manager.git

2. Compile the Golang program to generate an executable file

   go build -o pm

3. Create a pm_dir folder (you can use any name, just ensure it matches in the environment variable configuration)

4. Move pm.exe into pm_dir

5. Configure environment variables

• Open Control Panel → System → Advanced System Settings → Environment Variables

• Locate Path under System Variables or User Variables

• Click Edit, then add the absolute path of the pm_dir folder

• Save the changes and restart CMD

5. Verify installation

pm --help 

​