Metadata-Version: 2.1
Name: google-tui
Version: 0.1.0
Summary: A textual user interface to google.com
Home-page: https://github.com/wasi-master/google-tui
Author: Wasi Master
Author-email: arianmollik323@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/wasi-master/google-tui/issues
Project-URL: Source, https://github.com/wasi-master/google-tui
Project-URL: Say Thanks, https://saythanks.io/to/wasi-master
Keywords: google_tui,,google,,googlesearch,,python-googlesearch,,googlesearch-python,,python
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Terminals
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich
Requires-Dist: rich-click
Requires-Dist: textual
Requires-Dist: textual-inputs (==0.2.*)
Requires-Dist: async-cse

# google-tui

A textual user interface for [google.com](https://www.google.com)

## Prerequisites **(❗Read carefully❗)**

Firstly, you'll need to install the package

```sh
pip install google-tui
```

Secondly, you'll need to get google search api key(s)

1. Go to [developers.google.com/custom-search/v1/overview](https://developers.google.com/custom-search/v1/overview)
2. Scroll down
3. Click the big blue `Get a key` button ([screenshot](https://camo.githubusercontent.com/f784b64d7d88eb113230ce9c02b10df810262debfc35e64b3eaf79ca83ac45b4/68747470733a2f2f6d69786564616e616c79746963732e636f6d2f626c6f672f77702d636f6e74656e742f75706c6f6164732f676f6f676c652d7365617263682d6170692d696d67312e6a7067)])
4. Make a app if you haven't already, the name doesn't matter
5. Click the `NEXT` button
6. You'll get an api key

You can do the above process as many times as you want. Each api key has a 100 request limit per day, which is plenty for normal use but if you ever run out of uses you can just create more api keys

Thirdly, you'll need to provide the token(s) to the package.  You can use a environment variable named `GOOGLE_API_KEY` or you can pass the token(s) directly with the `--token`/`-t` flag. The environment variable/flag value should be comma separated without spaces (e.g. `a,b,c`) for multiple tokens or just a singe token (`a`).

Then you can go in a terminal and run

```sh
google-tui
```

And that should work, otherwise try

```sh
python -m google_tui
```



