安装指南

系统要求

在安装 EchoPlayer 之前，请确保您的系统满足以下要求：

操作系统支持

Windows

Windows 10/11 (64位)支持 x64 和 ARM64 架构

macOS

macOS 10.15+支持 Intel 和 Apple Silicon (M1/M2/M3)

Linux

Ubuntu 18.04+ 或其他主流发行版支持 x64 和 ARM64 架构

硬件要求

组件	最低要求	推荐配置
处理器	双核 1.6GHz	四核 2.0GHz 或更高
内存	4GB RAM	8GB RAM 或更高
存储空间	200MB 可用空间	1GB 可用空间
显卡	支持硬件加速的显卡	独立显卡

对于大型视频文件和高分辨率内容，建议使用更高的硬件配置以获得最佳体验。

下载安装包

官方下载渠道

访问 GitHub Releases 页面
选择最新版本
根据您的操作系统下载对应的安装包

安装包说明

文件名	适用系统	说明
`EchoPlayer-Setup-x.x.x.exe`	Windows	Windows 安装程序
`EchoPlayer-x.x.x.dmg`	macOS	macOS 磁盘映像
`EchoPlayer-x.x.x.AppImage`	Linux	Linux AppImage
`EchoPlayer_x.x.x_amd64.deb`	Ubuntu/Debian	DEB 安装包

安装步骤

Windows
macOS
Linux

Windows 安装

下载安装程序
- 下载 EchoPlayer-Setup-x.x.x.exe
运行安装程序
- 双击下载的 exe 文件
- 如果出现 Windows Defender 警告，点击”更多信息” → “仍要运行”
安装向导
- 选择安装语言
- 接受许可协议
- 选择安装位置（默认：C:\Program Files\EchoPlayer）
- 选择是否创建桌面快捷方式
完成安装
- 点击”安装”开始安装
- 安装完成后可选择立即启动

首次启动时，Windows 可能会显示安全警告，这是正常现象。请点击”仍要运行”继续。

macOS 安装

下载磁盘映像
- 下载 EchoPlayer-x.x.x.dmg
挂载映像
- 双击 dmg 文件挂载磁盘映像
- 可能需要输入管理员密码
安装应用
- 将 EchoPlayer.app 拖拽到 Applications 文件夹
- 等待复制完成
首次启动
- 在应用程序文件夹中找到 EchoPlayer
- 右键点击，选择”打开”
- 在安全提示中点击”打开”

EchoPlayer 已通过 Apple 公证，请放心使用。

Apple Silicon (M1/M2/M3) 用户

EchoPlayer 已针对 Apple Silicon 优化，可以原生运行获得最佳性能。

Linux 安装

方法一：AppImage（推荐）

下载 AppImage

wget https://github.com/mkdir700/EchoPlayer/releases/latest/download/EchoPlayer-x.x.x.AppImage

添加执行权限
chmod +x EchoPlayer-x.x.x.AppImage
运行应用
./EchoPlayer-x.x.x.AppImage

方法二：DEB 包（Ubuntu/Debian）

下载 DEB 包

wget https://github.com/mkdir700/EchoPlayer/releases/latest/download/EchoPlayer_x.x.x_amd64.deb

安装包

sudo dpkg -i EchoPlayer_x.x.x_amd64.deb
sudo apt-get install -f  # 解决依赖问题

启动应用
echoplayer

系统依赖

确保系统已安装以下依赖：

# Ubuntu/Debian
sudo apt update
sudo apt install libgtk-3-0 libgconf-2-4 libnss3 libxss1 libasound2

# CentOS/RHEL/Fedora
sudo yum install gtk3 GConf2 nss libXScrnSaver alsa-lib

验证安装

安装完成后，请验证 EchoPlayer 是否正常工作：

启动应用
- 在开始菜单、应用程序文件夹或终端中启动 EchoPlayer
检查版本
- 在应用中点击设置 → 关于，查看版本信息
测试基本功能
- 尝试添加一个测试视频文件
- 确认播放器可以正常播放

常见安装问题

Windows: 应用被 Windows Defender 阻止

这是因为 EchoPlayer 暂未获得微软数字签名。解决方法：

点击”更多信息”
选择”仍要运行”
或在 Windows Defender 中添加信任

请确保从官方 GitHub 仓库下载，避免安装恶意软件。

macOS: 无法打开应用，提示来自不明开发者

解决方法：

在 Applications 文件夹中找到 EchoPlayer
按住 Control 键点击应用图标
选择”打开”
在弹出对话框中点击”打开”

或者在系统偏好设置中：

前往”安全性与隐私”
在”通用”标签页中允许运行 EchoPlayer

Linux: 缺少依赖库

如果启动时提示缺少库文件，请安装对应依赖：

# 查看缺少的依赖
ldd EchoPlayer-x.x.x.AppImage

# 安装常见依赖
sudo apt install libgtk-3-0 libgconf-2-4 libnss3 libxss1 libasound2

安装后无法启动

请尝试以下步骤：

检查系统要求 - 确保满足最低系统要求
重新下载 - 可能是下载文件损坏
以管理员身份运行 - 某些系统可能需要管理员权限
检查防病毒软件 - 暂时禁用防病毒软件并重试
查看错误日志 - 在用户目录的 .echoplayer/logs 中查看错误信息

卸载 EchoPlayer

如果需要卸载 EchoPlayer：

Windows
macOS
Linux

通过”添加或删除程序”卸载
或运行安装目录下的 Uninstall EchoPlayer.exe
手动删除用户数据（可选）：
%APPDATA%\echoplayer

将 Applications 文件夹中的 EchoPlayer.app 拖到废纸篓 2. 清空废纸篓 3. 手动删除用户数据（可选）： ~/Library/Application Support/echoplayer

AppImage 方式：

直接删除 AppImage 文件
删除用户数据：~/.config/echoplayer

DEB 包方式：

sudo apt remove echoplayer

下一步

安装完成后，请查看快速开始指南了解如何使用 EchoPlayer 进行语言学习。

快速开始

学习如何添加视频和字幕，开始您的语言学习之旅

播放器概览

了解 EchoPlayer 的核心功能和界面布局

快速入门

播放器

高级

系统要求

操作系统支持

Windows

macOS

Linux

硬件要求

下载安装包

官方下载渠道

安装包说明

安装步骤

Windows 安装

macOS 安装

Apple Silicon (M1/M2/M3) 用户

Linux 安装

方法一：AppImage（推荐）

方法二：DEB 包（Ubuntu/Debian）

系统依赖

验证安装

常见安装问题

卸载 EchoPlayer

下一步

快速开始

播放器概览

​系统要求

​操作系统支持

Windows

macOS

Linux

​硬件要求

​下载安装包

​官方下载渠道

​安装包说明

​安装步骤

​Windows 安装

​macOS 安装

​Apple Silicon (M1/M2/M3) 用户

​Linux 安装

​方法一：AppImage（推荐）

​方法二：DEB 包（Ubuntu/Debian）

​系统依赖

​验证安装

​常见安装问题

​卸载 EchoPlayer

​下一步

快速开始

播放器概览

系统要求

操作系统支持

硬件要求

下载安装包

官方下载渠道

安装包说明

安装步骤

Windows 安装

macOS 安装

Apple Silicon (M1/M2/M3) 用户

Linux 安装

方法一：AppImage（推荐）

方法二：DEB 包（Ubuntu/Debian）

系统依赖

验证安装

常见安装问题

卸载 EchoPlayer

下一步