Metadata-Version: 2.1
Name: vimtips
Version: 0.2.6
Summary: Vim Tips is a project to aggregate and show vim tips from different sources.
Home-page: https://github.com/IngoHeimbach/vimtips
Author: Ingo Heimbach
Author-email: IJ_H@gmx.de
License: MIT
Description: # Vim Tips
        
        ## Introduction
        
        <img src="https://raw.githubusercontent.com/IngoHeimbach/vimtips/master/screenshot.png" width="540" />
        
        *Vim Tips* is a project to aggregate and show vim tips from different sources. A small daemon waits for screen unlocks
        and automatically starts the vim tips gui if it is the first unlock of the day.
        
        ## Installation
        
        *Vim Tips* can be installed with `pip` on Linux and macos:
        
        ```bash
        python3 -m pip install vimtips
        ```
        
        *Vim tips* contains components that must be compiled on installation, so ensure you have XCode installed on macos or
        build tools on any Linux distribution. For Linux, you also need X11 headers. On Ubuntu / Debian-based distributions you
        can install these dependencies with:
        
        ```bash
        apt install build-essential libx11-dev nx-x11proto-xext-dev
        ```
        
        If you run an Arch-bases system, you can also install `vimtips` from the
        [AUR](https://aur.archlinux.org/packages/vimtips/):
        
        ```bash
        yay -S vimtips
        ```
        
        ## Usage
        
        After installation, you get the new commands `vimtips-gui` and `vimtips-daemon` to start the graphical application or
        the daemon process. On the first gui start, the cache of vim tips is refreshed so the first startup can take several
        seconds. Future runs renew the cache in the background. You can add `vimtips-daemon` to your startup / login items to
        automatically get new tips on computer startup or when you unlock the screen for the first time of the day.
        
        ### Login item creation on macos
        
        It is indeed possible to add terminal commands to the user's login items but this will cause the startup of a terminal
        window every time you login to your Mac. A better solution is to start the preinstalled *Automator* application, create
        a new app and add a bash script which starts `vimtips-daemon`. The created app can then be added to hidden login items.
        
        ## Tip sources
        
        Currently, only twitter is supported as a tip source (the [vimtips](https://twitter.com/vimtips?lang=en),
        [VImTipsDaily](https://twitter.com/VImTipsDaily?lang=en), [vimpal](https://twitter.com/vimpal?lang=en) and
        [VimTip](https://twitter.com/vimpal?lang=en) accounts are read) but new sources can be added by creating a new Python
        module in `vimtips/sources`. Look at
        [vimtips/sources/twitter.py](https://raw.githubusercontent.com/IngoHeimbach/vimtips/master/vimtips/sources/twitter.py)
        for an example. You only need to implement a global function `tips` which returns a list of strings.
        
        ## Screen unlock detection
        
        This package has different backends to detect a screen unlock and automatically chooses an appropriate one:
        
        - Linux:
          - `xscreensaver`: If `xscreensaver` is running, it will be asked for unlock events.
          - `gnome-screensaver` and `xfce4-screensaver`: Can also be asked for unlock events.
          - `X11 dpms`: As a fallback, dpms events are watched which should work on every Linux desktop. However, this backend
            does not really check for a screen unlock, it checks the screen power state instead (however, in most configurations
            the screen is sent to sleep when the screen is locked, so this should be fine on most systems). This backend could
            fail if screensavers are used.
        - macos:
          - On macos, the screen power state is watched similar to the Linux X11 backend. If anyone knows how to check for a
            screen lock, please send a pull request! :)
        
Keywords: vim,tips
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Text Editors
Classifier: Topic :: Utilities
Requires-Python: ~=3.3
Description-Content-Type: text/markdown
