Skip to main content

May the LINE be with you...

Project description

|PyPi version| |PyPi downloads|

  • 2014.08.06 UPDATE : Echo bot example update!!!
  • 2014.08.06 UPDATE : We can send a sticker!!!
  • 2014.08.04 ANNOUNCE : This project is not completed yet :(

May the LINE be with you…

>>> from line import LineClient
>>> client = LineClient("carpedm20", "xxxxxxxxxx")
Enter PinCode '9779' to your mobile phone in 2 minutes
>>> client = LineClient("", "xxxxxxxxxx")
Enter PinCode '7390' to your mobile phone in 2 minutes
>>> print client.profile


First, you need to install Apache Thrift. Install instructions are here. (This might take some time…)


$ pip install line

Or, you can use:

$ easy_install line

Or, you can also install manually:

$ git clone git://
$ cd LINE
$ python install


First, you need to create a LineClinet object with YOUR_ID and YOUR_PASSWORD. YOUR ID can be LINE email address or NAVER id.

>>> from line import LineClient
>>> client = LineClient(YOUR_ID, YOUR_PASSWORD)
Enter PinCode '9779' to your mobile phone in 2 minutes

After you enter PinCode to your mobile phone, you will get authToken.

>>> authToken = client.authToken
>>> print authToken

With authToken, you don’t have to enter PinCode to your phone anymore!

>>> client = LineClient(authToken=authToken)
>>> print client.profile

View contacts and groups

You can see your contacts by:

>>> print client.contacts  # your friends
>>> print client.groups

Get contact and group from name

You can get contact and group from name by:

>>> contact = client.getContactFromName('CONTACT_NAME')
>>> group = client.getGroupFromName('GROUP_NAME')

Send a message

You can send a message by:

>>> client.contacts[0].sendMessage("test")
>>> client.groups[0].sendMessage("test")

Send a sticker

You can send a sticker by:

>>> client.contacts[0].sendSticker() # default option
>>> client.groups[0].sendSticker() # default option
>>> client.contacts[0].sendSticker(stickerId="1",stickerPackageId="1",stickerVersion="100")
>>> client.groups[0].sendSticker(stickerId="1",stickerPackageId="1",stickerVersion="100")

Get a list of recent message

You can read a recent message from contact or gruop by:

>>> messages = client.contacts[0].getRecentMessages(count=10)
>>> messages = client.groups[0].getRecentMessages(count=1)

Refresh contacts and groups

If there is any change of contacts. you need to update contacts by:

>>> client.refreshContacts()
>>> client.refreshGroups()




  • Get chat room list (currently only can get group and contact)
  • Long poll feature
  • Send a Image file
  • Make a echo bot example… (this is my major goal right now)
  • More usable methods and objects


Source codes are distributed under BSD license.


Taehoon Kim / @carpedm20

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for line, version 0.0.8
Filename, size File type Python version Upload date Hashes
Filename, size line-0.0.8.tar.gz (9.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page