add readme

+# xj-marketing
+social-auto-upload 该项目旨在自动化发布视频到各个社交媒体平台
+
+social-auto-upload This project aims to automate the posting of videos to various social media platforms.
+
+
+## 💡Feature
+- 中国主流社交媒体平台：
+  - [x] 抖音
+  - [x] 视频号
+  - [x] bilibili
+  - [x] 小红书
+  - [x] 快手
+  - [ ] 百家号
+  - [ ] 网易号
+
+- 部分国外社交媒体：
+  - [x] tiktok
+  - [ ] youtube
+
+---
+- [ ] 易用版本(支持非开发人员使用)：Gui or Cli
+- [ ] API 封装
+  - [ ] Docker 部署
+- [ ] 自动化上传(schedule)
+- [x] 定时上传(cron)
+- [ ] cookie 管理
+- [ ] 国外平台proxy 设置
+- [ ] 多线程上传
+- [ ] slack 推送
+
+
+# 💾Installation
+```
+pip install -r requirements.txt
+playwright install chromium firefox
+```
+
+
+# 核心模块解释
+
+### 1. 视频文件准备(video prepare)
+filepath 本地视频目录，目录包含(filepath Local video directory containing)
+
+- 视频文件(video files)
+- 视频meta信息txt文件(video meta information txt file)
+
+举例(for example)：
+
+file：2023-08-24_16-29-52 - 这位勇敢的男子为了心爱之人每天坚守 .mp4
+
+meta_file:2023-08-24_16-29-52 - 这位勇敢的男子为了心爱之人每天坚守 .txt
+
+meta_file 内容(content)：
+```angular2html
+这位勇敢的男子为了心爱之人每天坚守 🥺❤️‍🩹
+#坚持不懈 #爱情执着 #奋斗使者 #短视频
+```
+
+### Usage
+1. 设置conf 文件中的 `LOCAL_CHROME_PATH`(在douyin、视频号 tiktok可能出现chromium 不兼容的各种问题，建议设置本地的chrome)
+2. 这里分割出来3条路
+   - 可自行研究源码，免费、任意 穿插在自己的项目中
+   - 可参考下面的各个平台的使用指南，`examples`文件夹中有各种示例代码
+   - 使用cli 简易使用(支持tiktok douyin 视频号)
+
+#### cli 用法
+```python 
+python cli_main.py <platform> <account_name> <action: upload, login> [options]
+```
+查看详细的参数说明使用：
+```python
+python cli_main.py -h
+```
+```python
+usage: cli_main.py [-h] platform account_name action ...
+
+Upload video to multiple social-media.
+
+positional arguments:
+  platform      Choose social-media platform: douyin tencent tiktok kuaishou
+  account_name  Account name for the platform: xiaoA
+  action        Choose action
+    upload      upload operation
+    login       login operation
+    watch       watch operation
+
+options:
+  -h, --help    show this help message and exit
+
+```
+示例
+```python
+python cli_main.py douyin test login
+douyin平台，账号名为test，动作为login
+
+python cli_main.py douyin test upload "C:\Users\duperdog\Videos\2023-11-07_05-27-44 - 这位少女如梦中仙... .mp4" -pt 0
+douyin平台, 账号名为test, 动作为upload, 视频文件（需对应的meta文件，详见上）, 发布方式（pt）：0 立即发布
+
+python cli_main.py douyin test upload "C:\Users\superdog\Videos\2023-11-07_05-27-44 - 这位少女如梦中仙... .mp4" -pt 1 -t "2024-6-14 12:00"
+douyin平台, 账号名为test, 动作为upload, 视频文件, 发布方式（pt）：1 定时发布, 发布时间(t)： 2024-6-14 12:00
+```
+
+---
+
+## 各平台详细说明
+
+### 1. 抖音
+<img src="media/show/pdf3.gif" alt="douyin show" width="500"/>
+
+使用playwright模拟浏览器行为
+> 抖音前端实现，诸多css class id 均为随机数，故项目中locator多采用相对定位，而非固定定位
+1. 准备视频目录结构
+2. cookie获取：get_douyin_cookie.py 扫码登录
+3. 上传视频：upload_video_to_douyin.py 
+
+
+
+其他部分解释：
+```
+douyin_setup handle 参数为True，为手动获取cookie False 则是校验cookie有效性
+
+generate_schedule_time_next_day 默认从第二天开始（此举为避免选择时间的意外错误）
+参数解释：
+- total_videos 本次上传视频个数
+- videos_per_day 每日上传视频数量
+- daily_times 视频发布时间 默认6、11、14、16、22点
+- start_days 从第N天开始
+```
+
+> 2023年12月15日补充：使用chromium可能会出现无法识别视频封面图片的情况
+> 解决方案：
+> 1. 下载chrome
+> 2. 找到chrome的安装目录
+> 3. 将本地chrome 路径conf文件中 LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"
+
+
+参考项目：
+- https://github.com/wanghaisheng/tiktoka-studio-uploader
+- https://github.com/Superheroff/douyin_uplod
+- https://github.com/lishang520/DouYin-Auto-Upload.git
+
+---
+
+### 2. 视频号
+使用playwright模拟浏览器行为
+1. 准备视频目录结构
+2. cookie获取：get_tencent_cookie.py 扫码登录
+3. 上传视频：upload_video_to_tencent.py 
+
+
+
+其他部分解释：
+```
+参考上面douyin_setup 配置
+```
+
+> 视频号使用chromium会出现不支持上传视频，需要自行指定本地浏览器
+> 解决方案：
+> 1. 下载chrome
+> 2. 找到chrome的安装目录
+> 3. 将本地chrome 路径conf文件中 LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"
+
+---
+
+
+### 3. 小红书
+该实现，借助ReaJason的[xhs](https://github.com/ReaJason/xhs)，再次感谢。
+
+1. 目录结构同上
+2. cookie获取，可使用chrome插件：EditThisCookie
+- 设置导出格式
+![Alt text](media/20231009111131.png)
+- 导出
+![Alt text](media/20231009111214.png)
+3. 黏贴至 uploader/xhs_uploader/accounts.ini文件中
+
+
+#### 解释与注意事项：
+
+```
+xhs签名方式分为两种：
+- 本地签名 sign_locl （默认）
+- 自建签名服务 sign
+
+测试下来发现本地签名，在实际多账号情况下会存在问题
+故如果你有多账号分发，建议采用自建签名服务（todo 上传docker配置）
+```
+##### 疑难杂症
+遇到签名问题，可尝试更新 "utils/stealth.min.js"文件
+https://github.com/requireCool/stealth.min.js
+
+24.4.10 大多数人小红书失败的原因在于你的cookie有问题，请参照你cookie是不是如我这样
+![正确的cookie](media/xhs_error_cookie.png)
+
+关于xhs部分可参考作者： https://reajason.github.io/xhs/basic
+
+##### todo
+- 扫码登录方式（实验下来发现与浏览器获取的存在区别，会有问题，未来再研究）
+
+
+参考项目：
+- https://github.com/ReaJason/xhs
+
+---
+
+### 4. bilibili
+该实现，借助biliup的[biliup-rs](https://github.com/biliup/biliup-rs)，再次感谢。
+1. 准备视频目录结构
+2. cookie获取：`biliup.exe -u account.json login` 选项你喜欢的登录方式
+![登录方式](media/get_bili_cookie.png) 
+3. 上传视频：upload_video_to_bilibili.py
+
+#### 解释与注意事项：
+
+```
+bilibili cookie 长期有效（至少我运行2年以来是这样的）
+其他平台 诸如linux mac 服务器运行 请自行研究
+```
+参考项目：
+- https://github.com/biliup/biliup-rs
+
+---
+
+### 5. tiktok 
+使用playwright模拟浏览器行为(Simulating Browser Behavior with playwright)
+1. 准备视频目录结构(Prepare the video directory structure)
+2. 将本地chrome路径配置到conf文件中  LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"(Configure the local chrome path to the conf file)
+3. cookie获取(generate your cookie)：get_tk_cookie.py 
+![get tiktok cookie](media/tk_login.png) 
+4. 上传视频(upload video)：upload_video_to_tiktok.py
+
+24.7.3 update local chrome support:
+- you can upload your custom thumbnail(place `png` file at the path of `videos`)
+- if not, the system will take the first frame of the video as the thumbnail.
+- chrome drive can't login by gmail oauth. the google don't support it. (if you want login by google oauth you can use the `tk_uploader/main.py` old firefox.)
+- before the upload process change the language to eng.
+
+其他部分解释：
+```
+参考上面douyin_setup 配置
+```
+
+other part explain(for eng friends)：
+```
+tiktok_setup handle parameter is True to get cookie manually False to check cookie validity
+
+generate_schedule_time_next_day defaults to start on the next day (this is to avoid accidental time selection errors)
+Parameter explanation:
+- total_videos Number of videos uploaded this time
+- videos_per_day Number of videos uploaded per day
+- daily_times The video posting times are 6, 11, 14, 16, 22 by default.
+- start_days Starts on the nth day.
+```
+参考项目：
+- https://github.com/wkaisertexas/tiktok-uploader
+
+---
+
+### 其余部分(todo)
+整理后上传
+
+---
+
+## 其他优秀项目
+- https://github.com/KLordy/auto_publish_videos
+  - db支持
+  - 定期自动发布
+  - cookie db管理
+  - 视频去重
+  - 消息推送
+
+
+## 🐾Communicate
+[Donate as u like](https://www.buymeacoffee.com/hysn2001m)
+
+如果你也是`一个人`，喜欢`折腾`， 想要在如此恶劣的大环境寻找突破
+
+希望探索 #技术变现 #AI创业 #跨境航海 #自动化上传 #自动化视频 #技术探讨 
+
+可以来群里和大家交流
+
+|![Nas](media/mp.jpg)|![赞赏](media/QR.png)|
+|:-:|:-:|
+|后台回复 `上传` 加群交流|如果你觉得有用|
+
+
+## Star History
+> 如果这个项目对你有帮助，⭐以表示支持 
+
+[![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)
\ No newline at end of file