Skip to content

Latest commit

 

History

History
221 lines (147 loc) · 7.45 KB

README_zh_CN.md

File metadata and controls

221 lines (147 loc) · 7.45 KB
Raw

下载32位tickeys_0.2.5_i386.deb：http://pan.baidu.com/s/1c2BN3Pm

下载64位tickeys_0.2.5_amd64.deb：http://pan.baidu.com/s/1o8AhmwM

如果有任何问题或者建议，请在issue中提出

Join the chat at https://gitter.im/BillBillBillBill/Tickeys-linux Tickeys Icon

简介

Tickeys是一款很强大的键盘音效软件。Tickeys 自带了七种声音效果方案，有打字机、冒泡、机械键盘、剑气等。每天都听着键盘声音是不是很烦闷，现在有了这款神器你就可以瞬间帮助自己的键盘加上逼格特效。

这个软件之前发布了Windows和Mac版，Tickeys 是由 Nozama 所做的一个 Mac 平台的开源小项目 (GitHub)，Windows 版由黄飞实现。我使用了之后，觉得挺有意思的，因此用Python写了个Linux版的。

项目网站

http://www.yingdev.com/projects/tickeys

PyPI: https://pypi.python.org/pypi/tickeys

Tickeys的Mac版本

https://github.com/yingDev/Tickeys

安装说明

在不同发行版上可能会有因为文件的缺失或者环境不同导致无法使用，需要安装相关依赖。

下载打包好的安装包安装(建议)

  • 下载deb安装包：

下载32位tickeys_0.2.4_i386.deb：http://pan.baidu.com/s/1geOYtdp

下载64位tickeys_0.2.4_amd64.deb：http://pan.baidu.com/s/1o8AhmwM

  • 安装后，在启动器中找到Tickeys打开。

编译安装(需要安装依赖)：

  • 以下方法需要先执行sudo apt-get install python-dev python-pip python-kivy xdotool gksu来安装依赖，一般这样就可以满足运行条件了。
  • 安装库(注意版本)： sudo pip install cython==0.20.2 notify2 pyinstaller==3.0 kivy==1.9.0 evdev

快速编译安装：执行sudo apt-get install python-dev python-pip python-kivy xdotool && sudo easy_install tickeys。

方法1.自动安装

  • 执行sudo easy_install tickeys or sudo pip install tickeys安装
  • 然后通过 sudo tickeys 来打开 (sudo tickeys -c 打开CLI版本)

方法2.半自动安装

错误解决方案：

  • 无法隐藏窗口：

解决方法：使用sudo apt-get install xdotool 安装xdotool

  • 若没有setuptools or pip

解决方法：使用sudo apt-get install python-pip 安装

  • Python.h：没有那个文件或目录

解决方法：使用sudo apt-get install python-dev安装

  • ImportError: No module named Cython.Distutils

解决方法：使用sudo easy_install cython安装

  • ImportError: libSDL-1.2.so.0: cannot open shared object file: No such file or directory

    解决方法：使用yum install libSDL-1.2.so.0安装依赖

  • NotImplementedError: mixer module not available

    解决方法：同上

Debian and Ubuntu 用户则可以尝试安装:

* sudo apt-get install xdotool
* sudo apt-get install libsdl1.2-dev
* sudo apt-get install libsdl-mixer1.2
* sudo apt-get install libsdl-ttf2.0

使用说明

需要以root权限才能启动，实现了CLI版本和GUI版本，默认启动GUI版本，GUI版本启动后会自动隐藏，按QAZ123唤出窗口。

调整参数后会自动保存，下次开启会使用该设置。

Open at startup是开启开机自启动功能选项，开关置为ON开启功能，开关置为OFF关闭功能。

TODO

1.打开程序后出现气泡提醒（已实现） 2.使GUI真正后台化（已实现） 3.按最小化按钮或退出按钮隐藏GUI 4.程序运行情况输出到log文件中,以便调试（已实现）

开发

  • ####编码规范: PEP8

  • ####应用UI框架：Kivy

  • ####开源许可证： MIT License

依赖安装：

pip install -r requirements.txt

使用pyinstaller打包 命令：pyinstaller build.spec

播放音乐通过pygame的mixer实现。

键盘事件的获取通过evdev实现。

窗口的控制使用工具xdotool来实现。(另一方法是使用wmctrl来控制窗口)

xdotool的使用：

  • 获取窗口ID： WID=xdotool search "Tickeys" | head -1

  • 激活窗口： xdotool windowactivate --sync $WID xdotool windowmap --sync $WID && xdotool windowactivate --sync $WID

  • 隐藏窗口实现： xdotool getactivewindow windowunmap ～～xdotool getactivewindow windowminimize～～ 或 ～～xdotool getactivewindow windowmove 999 0～～

项目结构

Tickeys-linux

├── AUTHOURS
├── build.sh
├── build.spec               pyinstaller打包用
├── Changelog                版本变动说明
├── deb.sh
├── dist
│   ├── make_deb.sh          打包成deb包的脚本
├── lib                      运行所用的一些库
├── LICENSE
├── MANIFEST.in
├── README.md
├── screenshot              Tickeys截图文件
├── setup.py                分发用
├── tickeys
│   ├── locale              翻译文件
│   ├── build.py            cx_freeze打包，已不用
│   ├── CLI.py              启动CLI的模块
│   ├── config.py            处理配置保存和读取的模块
│   ├── GUI.py              启动GUI的模块
│   ├── __init__.py
│   ├── keyboardHandler.py  处理键盘输入的函数
│   ├── logger.py           日志记录函数，调试时使用
│   ├── requirements.txt    开发模块依赖包
│   ├── Resources           程序资源，包括音效，字体等
│   │   ├── data
│   │   │   ├── bubble
│   │   │   ├── Cherry_G80_3000
│   │   │   ├── Cherry_G80_3494
│   │   │   ├── drum
│   │   │   ├── mechanical
│   │   │   ├── sword
│   │   │   └── typewriter
│   │   │   ├── schemes.json
│   │   └── fonts
│   │       └── DroidSansFallbackFull.ttf
│   ├── run.py            程序入口
│   ├── run_with_CLI.py   程序入口，带CLI版（失败时运行CLI）
│   ├── soundPlayer.py       播放声效的模块
│   ├── startupHandler.py    控制开机自启动的模块
│   ├── tickeys           启动tickeys的脚本，打包时放进打包后的文件夹使用
│   ├── tickeys.png
│   ├── tickeys_tray.py   托盘，由于打包大小问题尚未放入
│   ├── tickeysui.kv      kv的ui文件，现在已直接写入GUI.py中
│   └── windowManager.py  提供窗口控制的方法
└── tickeys.egg-info

文件说明

  • build.py cx_freeze打包函数

  • run.py 存放入口函数

  • readme.txt 放进打包后程序文件夹的readme

  • requirements.txt

  • tickeys

  • CLI.py

  • GUI.py

  • config.py

  • tickeysui.kv

  • KeyboardHandler.py

  • logger.py

  • SoundPlayer.py

  • StartupHandler.py

问题

  • 目前在Fedora上好像无法使用GUI的，不知道是因为我用虚拟机开的问题还是Kivy这个框架的问题，因为提示The 3D features of the virtual machine will be disabled。

作者

Huang Xiongbiao

[email protected]