docs: 修改 readme 文件
Browse files
README.MD
CHANGED
|
@@ -1,65 +1,149 @@
|
|
| 1 |
# social-auto-upload
|
| 2 |
-
social-auto-upload 该项目旨在自动化发布视频到各个社交媒体平台
|
| 3 |
|
| 4 |
-
|
| 5 |
|
| 6 |
-
|
| 7 |
-
- 中国主流社交媒体平台:
|
| 8 |
-
- [x] 抖音
|
| 9 |
-
- [x] 视频号
|
| 10 |
-
- [x] bilibili
|
| 11 |
-
- [x] 小红书
|
| 12 |
-
- [x] 快手
|
| 13 |
-
- [x] 百家号
|
| 14 |
-
- [ ] qq視頻
|
| 15 |
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 19 |
|
| 20 |
---
|
| 21 |
-
- [ ] 易用版本(支持非开发人员使用):Gui or Cli
|
| 22 |
-
- [ ] API 封装
|
| 23 |
-
- [ ] Docker 部署
|
| 24 |
-
- [ ] 自动化上传(schedule)
|
| 25 |
-
- [x] 定时上传(cron)
|
| 26 |
-
- [ ] cookie 管理
|
| 27 |
-
- [ ] 国外平台proxy 设置
|
| 28 |
-
- [ ] 多线程上传
|
| 29 |
-
- [ ] slack 推送
|
| 30 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 31 |
|
| 32 |
-
|
| 33 |
-
```
|
| 34 |
-
pip install -r requirements.txt
|
| 35 |
-
playwright install chromium firefox
|
| 36 |
-
```
|
| 37 |
-
非程序员,[新手级教程](https://juejin.cn/post/7372114027840208911)
|
| 38 |
|
| 39 |
-
#
|
| 40 |
|
| 41 |
-
|
|
|
|
|
|
|
|
|
|
| 42 |
|
| 43 |
-
|
| 44 |
|
| 45 |
-
|
| 46 |
-
请查看[详细文档](https://sap-doc.nasdaddy.com/)
|
| 47 |
|
| 48 |
-
|
| 49 |
-
|
|
|
|
| 50 |
|
| 51 |
-
如果
|
| 52 |
|
| 53 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 54 |
|
| 55 |
-
可
|
| 56 |
|
| 57 |
-
|
| 58 |
-
|:-:|:-:|
|
| 59 |
-
|后台回复 `上传` 加群交流|如果你觉得有用|
|
| 60 |
|
|
|
|
| 61 |
|
| 62 |
-
|
| 63 |
-
> 如果这个项目对你有帮助,⭐以表示支持
|
| 64 |
|
| 65 |
[](https://star-history.com/#dreammis/social-auto-upload&Date)
|
|
|
|
| 1 |
# social-auto-upload
|
|
|
|
| 2 |
|
| 3 |
+
`social-auto-upload` 项目旨在帮助用户自动化地将视频发布到多个主流社交媒体平台。
|
| 4 |
|
| 5 |
+
<img src="media/show/tkupload.gif" alt="tiktok show" width="800"/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
|
| 7 |
+
## 目录
|
| 8 |
+
|
| 9 |
+
- [💡 功能特性](#💡功能特性)
|
| 10 |
+
- [🚀 支持的平台](#🚀支持的平台)
|
| 11 |
+
- [💾 安装指南](#💾安装指南)
|
| 12 |
+
- [🏁 快速开始](#🏁快速开始)
|
| 13 |
+
- [🐇 项目背景](#🐇项目背景)
|
| 14 |
+
- [📃 详细文档](#📃详细文档)
|
| 15 |
+
- [🐾 交流与支持](#🐾交流与支持)
|
| 16 |
+
- [🤝 贡献指南](#🤝贡献指南)
|
| 17 |
+
- [📜 许可证](#📜许可证)
|
| 18 |
+
- [⭐ Star History](#⭐Star-History)
|
| 19 |
+
|
| 20 |
+
## 💡功能特性
|
| 21 |
+
|
| 22 |
+
### 已支持平台
|
| 23 |
+
|
| 24 |
+
- **国内平台**:
|
| 25 |
+
- [x] 抖音
|
| 26 |
+
- [x] 视频号
|
| 27 |
+
- [x] Bilibili
|
| 28 |
+
- [x] 小红书
|
| 29 |
+
- [x] 快手
|
| 30 |
+
- [x] 百家号
|
| 31 |
+
- **国外平台**:
|
| 32 |
+
- [x] TikTok
|
| 33 |
+
|
| 34 |
+
### 核心功能
|
| 35 |
+
|
| 36 |
+
- [x] 定时上传 (Cron Job / Scheduled Upload)
|
| 37 |
+
- [ ] Cookie 管理 (部分实现,持续优化中)
|
| 38 |
+
- [ ] 国外平台 Proxy 设置 (部分实现)
|
| 39 |
+
|
| 40 |
+
### 计划支持与开发中
|
| 41 |
+
|
| 42 |
+
- **平台扩展**:
|
| 43 |
+
- [ ] QQ视频
|
| 44 |
+
- [ ] YouTube
|
| 45 |
+
- **功能增强**:
|
| 46 |
+
- [ ] 更易用的版本 (GUI / CLI 交互优化)
|
| 47 |
+
- [ ] API 封装
|
| 48 |
+
- [ ] Docker 部署
|
| 49 |
+
- [ ] 自动化上传 (更智能的调度策略)
|
| 50 |
+
- [ ] 多线程/异步上传优化
|
| 51 |
+
- [ ] Slack/消息推送通知
|
| 52 |
|
| 53 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 54 |
|
| 55 |
+
## 🚀支持的平台
|
| 56 |
+
|
| 57 |
+
本项目通过各平台对应的 `uploader` 模块实现视频上传功能。您可以在 <mcfolder name="examples" path="d:\Code\Awesome-Tools\1.Social_Tools\social-auto-upload__dreammis\examples"></mcfolder> 目录下找到各个平台的使用示例脚本。
|
| 58 |
+
|
| 59 |
+
每个示例脚本展示了如何配置和调用相应的 uploader。
|
| 60 |
+
|
| 61 |
+
## 💾安装指南
|
| 62 |
+
|
| 63 |
+
1. **克隆项目**:
|
| 64 |
+
```bash
|
| 65 |
+
git clone https://github.com/dreammis/social-auto-upload.git
|
| 66 |
+
cd social-auto-upload
|
| 67 |
+
```
|
| 68 |
+
|
| 69 |
+
2. **安装依赖**:
|
| 70 |
+
建议在虚拟环境中安装依赖。
|
| 71 |
+
```bash
|
| 72 |
+
pip install -r requirements.txt
|
| 73 |
+
```
|
| 74 |
+
|
| 75 |
+
3. **安装 Playwright 浏览器驱动**:
|
| 76 |
+
```bash
|
| 77 |
+
playwright install chromium firefox
|
| 78 |
+
```
|
| 79 |
+
根据您的需求,至少需要安装 `chromium`。`firefox` 主要用于 TikTok 上传(旧版)。
|
| 80 |
+
|
| 81 |
+
> 非程序员用户可以参考:[新手级教程](https://juejin.cn/post/7372114027840208911)
|
| 82 |
+
|
| 83 |
+
## 🏁快速开始
|
| 84 |
+
|
| 85 |
+
1. **准备 Cookie**:
|
| 86 |
+
大多数平台需要登录后的 Cookie 信息才能进行操作。请参照 examples 目录下各 `get_xxx_cookie.py` 脚本(例如 get_douyin_cookie.py, get_ks_cookie.py)的说明,运行脚本以生成并保存 Cookie 文件(通常在 `cookies/[PLATFORM]_uploader/account.json`)。
|
| 87 |
+
|
| 88 |
+
2. **准备视频文件**:
|
| 89 |
+
将需要上传的视频文件(通常为 `.mp4` 格式)放置在 videos 目录下。
|
| 90 |
+
部分平台支持视频封面,可以将封面图片(例如 `.png` 格式,与视频同名)也放在此目录。
|
| 91 |
+
如果需要上传标题及标签,请在视频文件旁边创建一个同名的 `.txt` 文件,内容为标题和标签,以换行分隔。
|
| 92 |
+
|
| 93 |
+
3. **修改并运行示例脚本**:
|
| 94 |
+
打开 examples 目录中您想使用的平台的上传脚本(例如 upload_video_to_douyin.py)。
|
| 95 |
+
- 根据脚本内的注释和说明,确认 Cookie 文件路径、视频文件路径等配置是否正确。
|
| 96 |
+
- 您可以修改脚本以适应您的具体需求,例如批量上传、自定义标题、标签等。
|
| 97 |
+
|
| 98 |
+
4. **执行上传**:
|
| 99 |
+
运行修改后的示例脚本,例如:
|
| 100 |
+
```bash
|
| 101 |
+
python examples/upload_video_to_douyin.py
|
| 102 |
+
```
|
| 103 |
+
|
| 104 |
+
## 🐇项目背景
|
| 105 |
+
|
| 106 |
+
该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布,因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。
|
| 107 |
+
|
| 108 |
+
如果您需要立即发布或其他定制化的发布策略,欢迎研究源码或在社区提问。
|
| 109 |
+
|
| 110 |
+
## 📃详细文档
|
| 111 |
+
|
| 112 |
+
更详细的文档和说明,请查看:[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/)
|
| 113 |
+
|
| 114 |
+
## 🐾交流与支持
|
| 115 |
|
| 116 |
+
[☕ Donate as u like](https://www.buymeacoffee.com/hysn2001m) - 如果您觉得这个项目对您有帮助,可以考虑赞助。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 117 |
|
| 118 |
+
如果您也是独立开发者、技术爱好者,对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作 等话题感兴趣,欢迎加入社群交流:
|
| 119 |
|
| 120 |
+
| 微信公众号 | 交流群 (通过公众号获取) |
|
| 121 |
+
| :----------------------------------------: | :------------------------------------------: |
|
| 122 |
+
|  |  |
|
| 123 |
+
| 关注公众号,后台回复 `上传` 获取加群方式 | 如果您觉得项目有用,可以考虑打赏支持一下 |
|
| 124 |
|
| 125 |
+
## 🤝贡献指南
|
| 126 |
|
| 127 |
+
欢迎各种形式的贡献,包括但不限于:
|
|
|
|
| 128 |
|
| 129 |
+
- 提交 Bug报告 和 Feature请求。
|
| 130 |
+
- 改进代码、文档。
|
| 131 |
+
- 分享使用经验和教程。
|
| 132 |
|
| 133 |
+
如果您希望贡献代码,请遵循以下步骤:
|
| 134 |
|
| 135 |
+
1. Fork 本仓库。
|
| 136 |
+
2. 创建一个新的分支 (`git checkout -b feature/YourFeature` 或 `bugfix/YourBugfix`)。
|
| 137 |
+
3. 提交您的更改 (`git commit -m 'Add some feature'`)。
|
| 138 |
+
4. Push到您的分支 (`git push origin feature/YourFeature`)。
|
| 139 |
+
5. 创建一个 Pull Request。
|
| 140 |
|
| 141 |
+
## 📜许可证
|
| 142 |
|
| 143 |
+
本项目暂时采用 [MIT License](LICENSE) 开源许可证。
|
|
|
|
|
|
|
| 144 |
|
| 145 |
+
## ⭐Star-History
|
| 146 |
|
| 147 |
+
> 如果这个项目对您有帮助,请给一个 ⭐ Star 以表示支持!
|
|
|
|
| 148 |
|
| 149 |
[](https://star-history.com/#dreammis/social-auto-upload&Date)
|