<commit_before># trollbox

Trollbox enables quick storage, tagging, and retrieval of images from the web. 

![example](https://raw.githubusercontent.com/jfoote/trollbox/master/trollbox/test/data/1/images/example.gif?token=<PASSWORD>)

Trollbox allows users to download, tag, and search for images quickly. The bold can run the app as root to enable instantaneous search via a glorified keylogger (please [understand how this works and the associated risks](https://github.com/jfoote/trollbox/blob/master/trollbox/wordlogger/__init__.py) if you choose to enable it). 

## About

This is a toy app that I developed as part of some ongoing software/security research. The primary function of this project is to act as a test bed for some HCI data collection and experimentation. The development stack was chosen for excessive (and perhaps unfortunate) familiarity, not optimality, as the app istelf is not the focus of the research. 

The idea for trollbox came from a concept of "thinking in gifs," which I've found to be a key skill for effective trolling of friends and colleagues in IRC, Slack, etc. :) 

## Requirements 

OSX is the only supported operating system at this time, though the development technologies used (Python, PySide, Qt4.8, C) should allow for porting. Just add elbow grease.

Trollbox depends on PySide. See [the documentation](https://pypi.python.org/pypi/PySide) for up-to-date instructions on installing it.

```
$ brew install qt
$ pip install -U PySide
$ pyside_postinstall.py -install
```

`pip install nose` is recommended for testing.

## Usage

Run Trollbox from its local directory. Such polished.

```
$ ./trollbox.py
```

Or, to enable wordlogging:

```
$ sudo ./trollbox.py
```

**Use at your own risk**

This app displays (i.e. processes) data from the internet, or any other network you are connected to. Proceed with caution. 

## TODO

These will probably never happen. But maybe.

- [ ] Perform richer semantic analysis of input
- [ ] Add "import from web" feature
- [ ] Port to Linux
- [ ] Port to Windows
- [ ] Automatically search online image resources
    - imgur
    - flickr
    - replygif
    - etc
- [ ] Automatically suggest tags
    - https://www.mashape.com/imagesearcher/camfind#!documentation
    - https://support.google.com/websearch/answer/1325808?hl=en
    - https://www.tineye.com/
- [ ] Add support for sharing trollboxes

## Development

Trollbox is a work in progress. If you actually install and use the app, please file any bugs in the Issue Tracker.

## Other Notes

If you end up using Trollbox please [let me know what you think](mailto:<EMAIL>). Happy trolling...
<commit_msg>fixed todo list<commit_after># trollbox

Trollbox enables quick storage, tagging, and retrieval of images from the web. 

![example](https://raw.githubusercontent.com/jfoote/trollbox/master/trollbox/test/data/1/images/example.gif?token=<PASSWORD>%3D%3D)

Trollbox allows users to download, tag, and search for images quickly. The bold can run the app as root to enable instantaneous search via a glorified keylogger (please [understand how this works and the associated risks](https://github.com/jfoote/trollbox/blob/master/trollbox/wordlogger/__init__.py) if you choose to enable it). 

## About

This is a toy app that I developed as part of some ongoing software/security research. The primary function of this project is to act as a test bed for some HCI data collection and experimentation. The development stack was chosen for excessive (and perhaps unfortunate) familiarity, not optimality, as the app istelf is not the focus of the research. 

The idea for trollbox came from a concept of "thinking in gifs," which I've found to be a key skill for effective trolling of friends and colleagues in IRC, Slack, etc. :) 

## Requirements 

OSX is the only supported operating system at this time, though the development technologies used (Python, PySide, Qt4.8, C) should allow for porting. Just add elbow grease.

Trollbox depends on PySide. See [the documentation](https://pypi.python.org/pypi/PySide) for up-to-date instructions on installing it.

```
$ brew install qt
$ pip install -U PySide
$ pyside_postinstall.py -install
```

`pip install nose` is recommended for testing.

## Usage

Run Trollbox from its local directory. Such polished.

```
$ ./trollbox.py
```

Or, to enable wordlogging:

```
$ sudo ./trollbox.py
```

**Use at your own risk**

This app displays (i.e. processes) data from the internet, or any other network you are connected to. Proceed with caution. 

## TODO

These will probably never happen. But maybe.

- [ ] Perform richer semantic analysis of input
- [ ] Add "import from web" feature
- [ ] Port to Linux
- [ ] Port to Windows
- [ ] Automatically search online image resources
    - imgur
    - flickr
    - replygif
    - etc
- [ ] Automatically suggest tags
    - https://www.mashape.com/imagesearcher/camfind#!documentation
    - https://support.google.com/websearch/answer/1325808?hl=en
    - https://www.tineye.com/
- [ ] Add support for sharing trollboxes
- [ ] Build the mobile version, become app store millionaire

## Development

Trollbox is a work in progress. If you actually install and use the app, please file any bugs in the Issue Tracker.

## Other Notes

If you end up using Trollbox please [let me know what you think](mailto:<EMAIL>). Happy trolling...

{'fraction_non_alphanumeric': 0.08583690987124463, 'fraction_numerical': 0.004105243515581265, 'mean_word_length': 3.9129239230064163, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 12, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1610535', 'n_tokens_mistral': 1581, 'n_tokens_neox': 1499, 'n_words': 672}