new-work

✨ Discover when artists post new work

Features

✨ Automagic: Automatically checks artists' websites for new work. Works by looking at a site's last-modified HTTP header or by diffing a specific HTML element.

📂 Organized: Keeps track of artists in various categories via a simple YAML file with a CLI helper.

⚡ Fast: Fetches sites in parallel for fast and efficient updates.

Installation

$ npm install new-work

Usage

Usage: newwork <command> [options]

  Commands:
    <default>                   Run 'newwork serve'
    serve                       Scrape, update, and serve a new-work page
    build                       Scrape, update, and save a new-work page to disk
    print                       Scrape, update, and print a table to the terminal 
    add [url]                   Add an URL to your list of sites
    remove [url]                Remove an URL from your list of sites
    ls                          List all sites in your new-work page

  Available options:
    -i, --input <filename>      Input YAML file [default: ~/.newwork.yaml]
    -o, --output <filename>     Output HTML file [default: ./newwork.html]
    -l, --lockfile <filename>   Lockfile location [default: ~/.newwork.lock]
    -p, --port=<n>              Bind 'newwork serve' to a port [default: 3030]
    -h, --help                  Print usage

Guide

1. Run newwork add <url> to add a site to track.

2. Confirm the site's title / the artist's name.

3. Optionally specify a category (e.g. 'Photography').

4. If the site returns a last-modified header, you're done! Otherwise, you must manually specify an HTML element to diff for updates.

5. Open the site with a web inspector such as Chrome DevTools Elements panel. Search for an HTML element that will change when the site is updated. The could be a thumbnail on the homepage, a menu of projects, or a blog post element.

   

6. Specify a jQuery selector that will return the chosen element. For example, a link element inside a thumbnail with the class thumb may be referenced by the selector .thumb a. Only the first matched element will be used.

7. Repeat for additional sites.

8. Run newwork or newwork serve to open a list of all your sites. Sites that have been changed in the last 30 days are highlighted with a "new" tag.

JS API

status

Get the status of a list of sites to see whether new work has been posted.

Parameters

• sites Array<Object>
  • sites.name String name of artist / title of site
  • sites.url String
  • sites.category String
  • sites.selector String? jQuery selector that will return an element to diff for changes
• lockfile String filename of lockfile to store previous diffs & metadata
• opts Object?
  • opts.expiration Number duration in ms for which a given site is still "new", default ms in one month
• cb

render

Render an HTML view of a list of sites, highlighting when new work has been posted.

Parameters

• sites Array<Object>
  • sites.name String name of artist / title of site
  • sites.url String
  • sites.category String
  • sites.selector String? jQuery selector that will return an element to diff for changes
• lockfile String filename of lockfile to store previous diffs & metadata
• opts Object?
  • opts.template Function template function to return str of HTML, given sites
  • opts.expiration Number duration in ms for which a given site is still "new", default ms in one month
• cb

See Also

• Hardly Everything - @jondashkyle 🙌

License

MIT