diff --git a/README.MD b/README.MD index c0e1dae..750028e 100644 --- a/README.MD +++ b/README.MD @@ -1,65 +1,149 @@ # social-auto-upload -social-auto-upload 该项目旨在自动化发布视频到各个社交媒体平台 + +`social-auto-upload` 项目旨在帮助用户自动化地将视频发布到多个主流社交媒体平台。 tiktok show -## 💡Feature -- 中国主流社交媒体平台: - - [x] 抖音 - - [x] 视频号 - - [x] bilibili - - [x] 小红书 - - [x] 快手 - - [x] 百家号 - - [ ] qq視頻 +## 目录 -- 部分国外社交媒体: - - [x] tiktok - - [ ] youtube +- [💡 功能特性](#💡功能特性) +- [🚀 支持的平台](#🚀支持的平台) +- [💾 安装指南](#💾安装指南) +- [🏁 快速开始](#🏁快速开始) +- [🐇 项目背景](#🐇项目背景) +- [📃 详细文档](#📃详细文档) +- [🐾 交流与支持](#🐾交流与支持) +- [🤝 贡献指南](#🤝贡献指南) +- [📜 许可证](#📜许可证) +- [⭐ Star History](#⭐Star-History) + +## 💡功能特性 + +### 已支持平台 + +- **国内平台**: + - [x] 抖音 + - [x] 视频号 + - [x] Bilibili + - [x] 小红书 + - [x] 快手 + - [x] 百家号 +- **国外平台**: + - [x] TikTok + +### 核心功能 + +- [x] 定时上传 (Cron Job / Scheduled Upload) +- [ ] Cookie 管理 (部分实现,持续优化中) +- [ ] 国外平台 Proxy 设置 (部分实现) + +### 计划支持与开发中 + +- **平台扩展**: + - [ ] QQ视频 + - [ ] YouTube +- **功能增强**: + - [ ] 更易用的版本 (GUI / CLI 交互优化) + - [ ] API 封装 + - [ ] Docker 部署 + - [ ] 自动化上传 (更智能的调度策略) + - [ ] 多线程/异步上传优化 + - [ ] Slack/消息推送通知 --- -- [ ] 易用版本(支持非开发人员使用):Gui or Cli -- [ ] API 封装 - - [ ] Docker 部署 -- [ ] 自动化上传(schedule) -- [x] 定时上传(cron) -- [ ] cookie 管理 -- [ ] 国外平台proxy 设置 -- [ ] 多线程上传 -- [ ] slack 推送 +## 🚀支持的平台 -# 💾Installation -``` -pip install -r requirements.txt -playwright install chromium firefox -``` -非程序员,[新手级教程](https://juejin.cn/post/7372114027840208911) +本项目通过各平台对应的 `uploader` 模块实现视频上传功能。您可以在 目录下找到各个平台的使用示例脚本。 -# 🐇 About +每个示例脚本展示了如何配置和调用相应的 uploader。 -该项目为我自用项目抽离出来,我的发布策略是定时发布(提前一天发布),故发布部分采用的事件均为第二天的时间 +## 💾安装指南 -如果你有需求立即发布,可自行研究源码或者向我提问 +1. **克隆项目**: + ```bash + git clone https://github.com/dreammis/social-auto-upload.git + cd social-auto-upload + ``` -# 📃详细文档 -请查看[详细文档](https://sap-doc.nasdaddy.com/) +2. **安装依赖**: + 建议在虚拟环境中安装依赖。 + ```bash + pip install -r requirements.txt + ``` -## 🐾Communicate -[Donate as u like](https://www.buymeacoffee.com/hysn2001m) +3. **安装 Playwright 浏览器驱动**: + ```bash + playwright install chromium firefox + ``` + 根据您的需求,至少需要安装 `chromium`。`firefox` 主要用于 TikTok 上传(旧版)。 -如果你也是`一个人`,喜欢`折腾`, 想要在如此恶劣的大环境寻找突破 +> 非程序员用户可以参考:[新手级教程](https://juejin.cn/post/7372114027840208911) -希望探索 #技术变现 #AI创业 #跨境航海 #自动化上传 #自动化视频 #技术探讨 +## 🏁快速开始 -可以来群里和大家交流 +1. **准备 Cookie**: + 大多数平台需要登录后的 Cookie 信息才能进行操作。请参照 examples 目录下各 `get_xxx_cookie.py` 脚本(例如 get_douyin_cookie.py, get_ks_cookie.py)的说明,运行脚本以生成并保存 Cookie 文件(通常在 `cookies/[PLATFORM]_uploader/account.json`)。 -|![Nas](media/mp.jpg)|![赞赏](media/QR.png)| -|:-:|:-:| -|后台回复 `上传` 加群交流|如果你觉得有用| +2. **准备视频文件**: + 将需要上传的视频文件(通常为 `.mp4` 格式)放置在 videos 目录下。 + 部分平台支持视频封面,可以将封面图片(例如 `.png` 格式,与视频同名)也放在此目录。 + 如果需要上传标题及标签,请在视频文件旁边创建一个同名的 `.txt` 文件,内容为标题和标签,以换行分隔。 +3. **修改并运行示例脚本**: + 打开 examples 目录中您想使用的平台的上传脚本(例如 upload_video_to_douyin.py)。 + - 根据脚本内的注释和说明,确认 Cookie 文件路径、视频文件路径等配置是否正确。 + - 您可以修改脚本以适应您的具体需求,例如批量上传、自定义标题、标签等。 -## Star History -> 如果这个项目对你有帮助,⭐以表示支持 +4. **执行上传**: + 运行修改后的示例脚本,例如: + ```bash + python examples/upload_video_to_douyin.py + ``` + +## 🐇项目背景 + +该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布,因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。 + +如果您需要立即发布或其他定制化的发布策略,欢迎研究源码或在社区提问。 + +## 📃详细文档 + +更详细的文档和说明,请查看:[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/) + +## 🐾交流与支持 + +[☕ Donate as u like](https://www.buymeacoffee.com/hysn2001m) - 如果您觉得这个项目对您有帮助,可以考虑赞助。 + +如果您也是独立开发者、技术爱好者,对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作 等话题感兴趣,欢迎加入社群交流: + +| 微信公众号 | 交流群 (通过公众号获取) | +| :----------------------------------------: | :------------------------------------------: | +| ![NasDaddy公众号](media/mp.jpg) | ![赞赏码/入群引导](media/QR.png) | +| 关注公众号,后台回复 `上传` 获取加群方式 | 如果您觉得项目有用,可以考虑打赏支持一下 | + +## 🤝贡献指南 + +欢迎各种形式的贡献,包括但不限于: + +- 提交 Bug报告 和 Feature请求。 +- 改进代码、文档。 +- 分享使用经验和教程。 + +如果您希望贡献代码,请遵循以下步骤: + +1. Fork 本仓库。 +2. 创建一个新的分支 (`git checkout -b feature/YourFeature` 或 `bugfix/YourBugfix`)。 +3. 提交您的更改 (`git commit -m 'Add some feature'`)。 +4. Push到您的分支 (`git push origin feature/YourFeature`)。 +5. 创建一个 Pull Request。 + +## 📜许可证 + +本项目暂时采用 [MIT License](LICENSE) 开源许可证。 + +## ⭐Star-History + +> 如果这个项目对您有帮助,请给一个 ⭐ Star 以表示支持! [![Star History Chart](https://api.star-history.com/svg?repos=dreammis/social-auto-upload&type=Date)](https://star-history.com/#dreammis/social-auto-upload&Date)