Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pythonity/twitter-banner-switcher

Python script that sets your Twitter profile banner to a random image from a specified folder or a list of paths.
https://github.com/pythonity/twitter-banner-switcher

cli command-line-tool twitter

Last synced: about 19 hours ago
JSON representation

Python script that sets your Twitter profile banner to a random image from a specified folder or a list of paths.

Host: GitHub
URL: https://github.com/pythonity/twitter-banner-switcher
Owner: Pythonity
License: mit
Created: 2016-06-30T08:40:11.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2017-06-15T11:19:02.000Z (over 7 years ago)
Last Synced: 2024-10-06T12:19:05.785Z (about 1 month ago)
Topics: cli, command-line-tool, twitter
Language: Python
Size: 6.84 KB
Stars: 3
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # twitter-banner-switcher

[![PyPI Version](https://img.shields.io/pypi/v/twitter-banner-switcher.svg)][tbs pypi]

[![Python Versions](https://img.shields.io/pypi/pyversions/twitter-banner-switcher.svg)][tbs pypi]

[![License](https://img.shields.io/github/license/Pythonity/twitter-banner-switcher.svg)][license]

Python (3) script that sets your Twitter profile banner to a random

image from a specified folder or a list of paths.

## Installation

With `PyPI` (recommended):

```shell

$ pip3 install twitter-banner-switcher

```

With `git clone`:

```shell

$ git clone https://github.com/Pythonity/twitter-banner-switcher

$ pip3 install -r twitter-banner-switcher/requirements.txt

$ cd twitter-banner-switcher/bin

```

## Usage

```

$ twitter-banner-switcher -h

Usage: twitter-banner-switcher [OPTIONS]

  Set Twitter profile banner to a random image from a specified folder or a

  list of paths

Options:

  -c, --config-file FILENAME  Path to YAML config file (default: ~/.twitter-

                              banner-switcher.yml).

  -h, --help                  Show this message and exit.

```

## Examples

Not much to show here - you can provide path to config file:

```shell

$ twitter-banner-switcher -c twitter-banner-switcher.yaml

```

or save it at `~/.twitter-banner-switcher.yaml` and just run the damn

thing:

```shell

$ twitter-banner-switcher

```

### Example config file

```yaml

$ cat twitter-banner-switcher.yaml

consumer_key: "Twitter consumer key"

consumer_secret: "Twitter consumer secret"

access_token: "Twitter access token"

access_token_secret: "Twitter access token secret"

banner_images:

    - "/home/bender/Photos/Awesome Twitter Banners/"

    - "/home/bender/Downloaded/planet_express.png"

```

Note: `banner_images` can be a path or a list of paths (to directories

containing images or directly to image files). Recognized formats are `gif`,

`jpg`, `jpeg` and `png`.

## Contributions

Package source code is available at [GitHub][tbs github].

Feel free to use, ask, fork, star, report bugs, fix them, suggest 

enhancements and point out any mistakes.

## Authors

Developed and maintained by [Pythonity][pythonity], a group of Python enthusiasts who love open source, have a neat [blog][pythonity blog] and are available [for hire][pythonity].

Written by [Paweł Adamczak][pawelad].

[tbs github]: https://github.com/Pythonity/twitter-banner-switcher

[tbs pypi]: https://pypi.python.org/pypi/twitter-banner-switcher

[license]: https://github.com/Pythonity/twitter-banner-switcher/blob/master/LICENSE

[pythonity]: https://pythonity.com/

[pythonity blog]: http://blog.pythonity.com/

[pawelad]: https://github.com/pawelad