Edan233 commited on
Commit
655f61f
·
1 Parent(s): 54cc0a7

docs: 修改 readme 文件

Browse files
Files changed (1) hide show
  1. README.MD +128 -44
README.MD CHANGED
@@ -1,65 +1,149 @@
1
  # social-auto-upload
2
- social-auto-upload 该项目旨在自动化发布视频到各个社交媒体平台
3
 
4
- <img src="media/show/tkupload.gif" alt="tiktok show" width="800"/>
5
 
6
- ## 💡Feature
7
- - 中国主流社交媒体平台:
8
- - [x] 抖音
9
- - [x] 视频号
10
- - [x] bilibili
11
- - [x] 小红书
12
- - [x] 快手
13
- - [x] 百家号
14
- - [ ] qq視頻
15
 
16
- - 部分国外社交媒体:
17
- - [x] tiktok
18
- - [ ] youtube
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
- # 💾Installation
33
- ```
34
- pip install -r requirements.txt
35
- playwright install chromium firefox
36
- ```
37
- 非程序员,[新手级教程](https://juejin.cn/post/7372114027840208911)
38
 
39
- # 🐇 About
40
 
41
- 该项目为我自用项目抽离出来,我的发布策略是定时发布(提前一天发布),故发布部分采用的事件均为第二天的时间
 
 
 
42
 
43
- 如果你有需求立即发布,可自行研究源码或者向我提问
44
 
45
- # 📃详细文档
46
- 请查看[详细文档](https://sap-doc.nasdaddy.com/)
47
 
48
- ## 🐾Communicate
49
- [Donate as u like](https://www.buymeacoffee.com/hysn2001m)
 
50
 
51
- 如果你也是`一个人`喜欢`折腾`, 想要在如此恶劣的大环境寻找突破
52
 
53
- 希望探索 #技术变现 #AI创业 #跨境航海 #自动化上传 #自动化视频 #技术探讨
 
 
 
 
54
 
55
- 以来群里和大家交流
56
 
57
- |![Nas](media/mp.jpg)|![赞赏](media/QR.png)|
58
- |:-:|:-:|
59
- |后台回复 `上传` 加群交流|如果你觉得有用|
60
 
 
61
 
62
- ## Star History
63
- > 如果这个项目对你有帮助,⭐以表示支持
64
 
65
  [![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)
 
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
+ | ![NasDaddy公众号](media/mp.jpg) | ![赞赏码/入群引导](media/QR.png) |
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
  [![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)