Skip to content

leynos/el-takeaway

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

El Takeaway

A tool to manage data retrieved from the Ello social network

Usage

chmod 500 the et binary and place it somewhere in your executable path.

et command [options ...]

Where command is one of:

pull

Retrieve the latest published articles from a given user:

et pull [username]

Specify a username to retrieve posts from. Subsequently, this username may be omitted. as it will be written to the .et conf file in the current directory

This is intended to be used in conjunction with a version control tool such as git or mercurial to allow you to more easily track the changes you have made to your Ello posts and comments.

Options:

-i filename.json

pull changes from a json file retrieved manually

-a

following successful pull, retrieve post assets

-p

Attempt to retrieve the data using browser credentials.

-b browser

Specify the browser to use for retreiving credentials. If not supplied, the value in the .et conf file will be used. If supplied, the conf file value will be overwritten.

Supported browsers:

firefox
chromium
chrome

tag

Apply tag(s) to a given file:

et tag filename tag1 tag2 ...
et tag id tag1 tag2 ...

Any tags already present in the filename will be ignored.

If the current directory is in version control, the VCS will be used to rename the file. Else, the OS's mv command will be used.

pull_assets

Retrieve all assets associated with previously retrieved posts

Assets are downloaded to:

./assets/{post_id}/{asset_id}-{asset_filename}

Testing

To test, first install shunit2 (see Prerequisites). To execute tests, run ./tests.

Prerequisites

This tool was developed on FreeBSD, but I don't see any reason why it shouldn't run on Linux or Mac OS X. It uses bash, curl, grep, awk and jq. The latter is the only component that may not be installed on your system by default. Consult your operating system handbook for instructions on installing this. Just kidding. The instructions are here.

For testing, shunit2 should be in a directory in your executable PATH variable, and set to +x.

Disclaimers etc.

This software is provided "AS IS" in the hope that someone may find it useful. If it deletes all your backed up Ello posts, please don't kill me.

'Ello' is a trademark of Ello, PBC. Its usage here is not intended to imply any endorsement, association or any other kind of relationship or representation.

About

A tool for managing data from the Ello social network

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published