https://github.com/savetz/tiara
The Internet Archive Research Assistant - Daily search Internet Archive for new items matching your keywords
https://github.com/savetz/tiara
internetarchive research research-tool
Last synced: about 1 year ago
JSON representation
The Internet Archive Research Assistant - Daily search Internet Archive for new items matching your keywords
- Host: GitHub
- URL: https://github.com/savetz/tiara
- Owner: savetz
- License: mit
- Created: 2021-05-28T16:24:25.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-29T19:27:47.000Z (over 2 years ago)
- Last Synced: 2025-04-18T05:41:54.043Z (about 1 year ago)
- Topics: internetarchive, research, research-tool
- Language: Python
- Homepage:
- Size: 2.04 MB
- Stars: 74
- Watchers: 6
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TIARA [![Badge License]][License]
*The Internet Archive Research Assistant*
---
[![Button Archive]][Internet Archive]
[![Button Bugs]][Bugs]
[![Button Donate]][Donate]
---
A tool to search the **[Internet Archive]**
for new items matching your keyword
search-list.
Can be run with **[CronTab]** for daily
updates about new items relevant
to your ongoing research.
It keeps track of the items you have
discovered in the past and will only
alert you to ones new to you.
Findings are placed in an **HTML** file,
which can be sent as an email via
SendGrid or your system's e-mail.
## Usage
Simply place your keywords / phrases into [`/Source/searchlist.txt`][SearchList] .
### Example
```txt
"Pliny The Elder"
Willamette River
Atari 1200XL computer
...
```
### Notes
*Put words in double quotes to do an exact phrase match.*
*Willamette River without quotes will find documents that have both of those words, perahps pages apart.*
*"Willamette River" with quotes will find documents with those words together.*
*Try not to use generic terms like `dogs` , as this will return too many daily hits.*
## Requirements
- The script requires read / write access to its directory
- **[Internet Archive Command Line Tool][IACLT]**
```sh
pip3 install internetarchive
```
[Internet Archive]: https://archive.org/
[SendGrid]: https://sendgrid.com/
[CronTab]: https://github.com/cronie-crond/cronie
[Twitter]: https://twitter.com/kaysavetz
[Donate]: https://archive.org/donate/
[IACLT]: https://github.com/jjjake/internetarchive
[SearchList]: Source/searchlist.txt
[License]: LICENSE
[Bugs]: Documentation/Bugs.md
[Badge License]: https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge
[Button Archive]: https://img.shields.io/badge/Internet_Archive-666666?style=for-the-badge&logo=InternetArchive&logoColor=white
[Button Donate]: https://img.shields.io/badge/Donate-yellow?style=for-the-badge&logo=InternetArchive&logoColor=white
[Button Bugs]: https://img.shields.io/badge/Bugs-6A5FBB?style=for-the-badge