Skip to main content

Python package for making fun pictures

Project description

meme-generator

✨ 表情包生成器,用于制作各种沙雕表情包 ✨

license Python pypi qq group

Note

额外表情仓库:meme-generator-contrib

表情列表

表情详细信息、表情预览等可以在 --> 表情列表 <-- 查看

安装

本地安装

本地安装、图片下载、字体安装方式等可以在 --> 本地安装 <-- 查看

Docker

Docker 部署方式可以在 --> Docker部署 <-- 查看

使用

通过 python 程序调用

参考 docs/examples/test_meme.py

通过命令行使用

meme -h/--help
  • meme list (ls) 列出所有已加载的表情

  • meme info (show) KEY 查看某个表情的详细信息,如:meme info petpet

  • meme preview KEY 使用默认(随机)参数生成预览结果,如:meme preview petpet

  • meme generate (make) KEY --text TEXTS --images IMAGES ... 制作表情,如:meme generate petpet --images avatar.jpg

    部分表情有额外的参数,可通过 -h/--help 查看,如:meme generate petpet --help

  • meme run (start) 启动 web server,可通过 api 方式调用

  • meme download 下载内置的表情包所需的图片

通过 api 方式使用

执行 meme run 可以启动 web 服务器

web 框架用的是 FastApi , 可查看自动生成的交互式 API 文档(访问 http://127.0.0.1:2233/docs

可以调用 api 接口使用,python 调用方式可参考 docs/examples/test_api.py

接入聊天机器人使用

配置

默认配置文件位置:

  • Windows: C:\Users\<username>\AppData\Roaming\meme_generator\config.toml
  • Linux: ~/.config/meme_generator/config.toml
  • Mac: ~/Library/Application Support/meme_generator/config.toml

Warning

从 v0.0.6 版本开始,不再生成默认配置文件;修改配置时需在对应的文件位置自行创建配置文件

由于 v0.0.6 版本更改了资源链接的拼接方式,如果装过之前的版本,需要修改配置中的 resource_url

建议将配置文件中不需要更改的选项删除,以使用默认配置

默认配置:

[meme]
load_builtin_memes = true  # 是否加载内置表情包
meme_dirs = []  # 加载其他位置的表情包,填写文件夹路径
meme_disabled_list = []  # 禁用的表情包列表,填写表情的 `key`

[resource]
# 下载内置表情包图片时的资源链接,下载时选择最快的站点
resource_urls = [
  "https://raw.githubusercontent.com/MeetWq/meme-generator/",
  "https://ghproxy.com/https://raw.githubusercontent.com/MeetWq/meme-generator/",
  "https://fastly.jsdelivr.net/gh/MeetWq/meme-generator@",
  "https://raw.fastgit.org/MeetWq/meme-generator/",
  "https://raw.fgit.ml/MeetWq/meme-generator/",
  "https://raw.gitmirror.com/MeetWq/meme-generator/",
  "https://raw.kgithub.com/MeetWq/meme-generator/",
]

[gif]
gif_max_size = 10.0  # 限制生成的 gif 文件大小,单位为 Mb
gif_max_frames = 100  # 限制生成的 gif 文件帧数

[translate]
baidu_trans_appid = ""  # 百度翻译api相关,表情包 `dianzhongdian` 需要使用
baidu_trans_apikey = ""  # 可在 百度翻译开放平台 (http://api.fanyi.baidu.com) 申请

[server]
host = "127.0.0.1"  # web server 监听地址
port = 2233  # web server 端口

[log]
log_level = "INFO"  # 日志等级

加载其他表情

如果希望加载非本仓库内置的表情,可以在 配置文件 中填写表情所在的文件夹路径

如以下的文件夹:

/path/to/your/meme_dir
└── meme1
    └── __init__.py
└── meme2
    └── __init__.py

在配置文件中修改 meme_dirs 如下:

[meme]
meme_dirs = ["/path/to/your/meme_dir"]

开发

如果希望编写、贡献新的表情,可以参考 --> 新表情编写指北 <--

对于一些不适合放在主仓库的表情,可以提交至 额外表情仓库

声明

本仓库的表情素材等均来自网络,如有侵权请联系作者删除

鸣谢

本仓库的表情整合自原 nonebot-plugin-petpetnonebot-plugin-memes 仓库

感谢以下开发者作出的贡献:

部分表情素材或代码参考了以下项目,感谢这些项目的开发者们

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meme_generator-0.0.16.tar.gz (74.7 kB view hashes)

Uploaded Source

Built Distribution

meme_generator-0.0.16-py3-none-any.whl (167.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page