# TIMELINE

Display your main timeline.

This is also called the 'Unified stream': it regroups the posts of people you follow and the posts mentioning you.

`ayadn timeline`

`ayadn -tl`


## AVAILABLE OPTIONS

### SCROLL

Scroll your timeline with:

`ayadn timeline --scroll`

`ayadn -tl -s`

#### SCROLL REFRESH

*Read this if you want to launch several scroll streams at once*

Ayadn pulls the stream every 3 seconds by default. It means you can launch up to 3 scroll streams at a time _per account_ if you want. 

To launch even more streams at the same time, increment the timer by one second for each stream. 

Example: to launch 10 streams, set the timer to 12 seconds *before launching the streams* with `ayadn set scroll timer 12`.

On the contrary, you can bring that value down to 1 second if you're using only _one_ scroll stream per account at a time.

App.net accepts 5000 requests per hour per account maximum. If Ayadn ends up making too many requests to ADN, it will display an alert message with instructions, then it will exit.

### COUNT

Ayadn displays a certain number of posts by default when you request a stream.

With the *count* option, you can set a specific value for each request:

`ayadn timeline --count=10`

`ayadn -tl -c10`

The maximum value is 200 for any stream.

### INDEX

Shows an index instead of the posts ids.

`ayadn timeline --index`

`ayadn -tl -i`  

This is particularly useful if you're using Ayadn to *reply* to conversations.

Copy/pasting the post id can be tedious at times, and anyway it's faster to glance at a short number and use it immediately.

Example:

`ayadn -tl -i`

`ayadn -R 33`

if 33 is the number of the indexed post you want to reply to.  

### NEW

Displays only the new posts in the stream since your last visit.

`ayadn timeline --new`

`ayadn -tl -n`

### RAW

Displays the raw response from the App.net API instead of the formatted Ayadn output.  

`ayadn timeline --raw`

`ayadn -tl -x`

### EXTRACT

Extracts all links from posts.

`ayadn hashtag --extract instagram`

`ayadn -t -e instagram`

`ayadn search --extract ruby gem`  

`ayadn -s -e ruby gem`  

`ayadn whatstarred @ericd -e`

`ayadn -was -e ericd`

### FORCE

Force view blacklisted/muted/blocked user's posts with `-f` option. 

`ayadn -gl -f`

`ayadn -gl -s -f`

Differences will occur due to ADN policy:

- Global stream: temporarily disables you user token (so your muted/blocked preferences don't apply), the NiceRank filter, and the Blacklist databases

- User's posts and Post infos: temporarily disables you user token and the Blacklist databases

- Other streams, search, tags: temporarily disables the Blacklist databases

### COMPACT

Removes the line-breaks when possible, and forces the view to be "compact".

Set it with:

`ayadn set timeline compact true`

You may want to change colors to create visual marks between posts if you choose the compact view, i.e. putting the all header in the same color (post id, username, name, etc).


# GLOBAL

Display the 'Global stream'.

`ayadn global`

`ayadn -gl`

Although the 'Global stream' is nowadays infested with spammers, it remains a fantastic source to find new people to interact with.

Ayadn helps you in that task with two tools:

- the *blacklist* command, which allows you to mute posters per client name, hashtag or mention, obliterating the unwanted posts

- the *NiceRank* filter, which allows you to filter spammers out


# CHECKINS

Display the 'Checkins stream'.

Ayadn will show any available geolocation data for these posts.

`ayadn checkins`

`ayadn -ck`

# CONVERSATIONS

Display the 'Conversations stream'.

This is a stream of posts that lead to *conversations* with real people.

`ayadn conversations`

`ayadn -cq`

# TRENDING

Display the 'Trending stream'.

This is a stream of trending posts.

`ayadn trending`

`ayadn -tr`

# PHOTOS

Display the 'Photos stream'.

This is a stream of posts including a picture.

`ayadn photos`

`ayadn -ph`  

# MENTIONS

Display posts containing a mention of @username.

`ayadn mentions @ericd`

`ayadn -m @ericd`  

You can get your own mentions stream by using *me* instead of *@username*:

`ayadn -m me`

Don't forget that like most streams, Mentions is *scrollable*: very convenient to know at a glance if we got something new from our friends!

# POSTS

Show the posts of a specific user.

`ayadn userposts @ericd`

`ayadn -up @ericd`

You can get your own posts by using *me* instead of *@username*:

`ayadn -up me`

# MESSAGES

Show messages in a *channel*.

`ayadn messages 46217`

`ayadn -ms 46217`

You can replace the channel id with its alias if you previously defined one:

`ayadn -ms mychannelalias`  

Since version 1.7.7, Ayadn shows the full oembed links in messages if any. As these links can be quite long and complex, you can remove them from the view if you want with `ayadn set timeline show_channel_oembed false`.  

# WHATSTARRED

Show posts starred by a specific user.

`ayadn whatstarred @ericd`

`ayadn -was @ericd`

You can get your own stars by using *me* instead of *@username*:

`ayadn -was me`

# CONVO

Show the conversation thread around a specific post.

`ayadn convo 23362788`

`ayadn -co 23362788`

# HASHTAG

Show recent posts containing #HASHTAG(s).

`ayadn hashtag nowplaying`

`ayadn -t nowplaying`

`ayadn -t nowplaying rock`

# SEARCH

Show recents posts containing WORD(s).

`ayadn search ruby`

`ayadn search ruby json api`

## Search in messages, including PMs

You can now search for WORD(S) in the messages of a channel, for example all PMs between you and @username.

You have to specify a channel id (or an alias).

```
ayadn search --messages 24573 'meet me at'
ayadn search --messages my_alias 'meet me at'
```

If you don't know what are your subscribed channels ids, discover them with `ayadn -ch`, then you can also set aliases with `ayadn -A create 24573 my_alias` to remember the names easily.

## Look for users

Look for App.net users by searching WORD(S) in their bio/description.

`ayadn search --users coffee food`

Returns a detailed view of each user's profile and informations.

## Discover channels

Search for App.net channels by searching WORD(S) in their description.

`ayadn search --channels podcast ios`

(This one operation may *sometimes* be long to execute if there's a lot of results.)

If the channel (let's say 24573) is public, you can read its messages with `ayadn -ms 24573` or `ayadn -ms my_alias`.

## Search ADN annotations

For the developers -or the adventurous-, there's a command to search for annotations types.

`ayadn search --annotations net.app.ohai.location`

# USER INFO

Show informations about a user.

`ayadn userinfo @ericd`

`ayadn -ui @ericd`

You can see your own info by using *me* instead of *@username*:

`ayadn -ui me`

# POST INFO

Show informations about a post.

`ayadn postinfo 23362788`

`ayadn -pi 23362788` 

# RANDOM

Show series of random posts from ADN. Just for fun :)

`ayadn random`

`ayadn -rnd`