termtweet 1.0.0

A simple CLI tool to tweet from your terminal

TermTweet

A simple, powerful Python script to tweet directly from your terminal or IDE. Perfect for developers who want to share code updates, project milestones, or quick thoughts while working on their projects.

✨ Features

• 🚀 Tweet from terminal - Post text tweets directly from command line
• 📸 Image support - Attach images by providing file path
• 🔐 Secure authentication - Environment variables keep credentials safe
• ⚡ Easy setup - Interactive setup script guides you through configuration
• 🛠️ Developer-friendly - Works from any directory, perfect for coding sessions
• 📝 Input validation - Automatic tweet length checking (280 chars max)

📋 Prerequisites

• Python 3.8 or higher
• Twitter Developer Account with API v2 access

🚀 Installation

Option 1: Install from PyPI (Recommended)

# Install globally (like npm install -g)
pip install termtweet

# Run setup
termtweet --setup

Option 2: Install from Source

# Clone the repository
git clone https://github.com/yourusername/termtweet.git
cd termtweet

# Install in development mode
pip install -e .

# Run setup
termtweet --setup

Option 3: Manual Setup (Advanced)

# Clone and install dependencies
git clone https://github.com/yourusername/termtweet.git
cd termtweet
pip install -r requirements.txt

# Configure credentials manually
cp .env.example .env
# Edit .env with your Twitter API credentials

📖 Usage

Basic tweet:

termtweet "Hello from the terminal! #coding"

Tweet with image:

termtweet "Check out this cool screenshot!" --image ./screenshot.png

Short options:

termtweet "Quick tweet!" -i image.png

Test your setup:

termtweet --test

Run setup:

termtweet --setup

💡 Examples

# Share coding progress
termtweet "Just implemented a new feature! 🚀 #programming"

# Post with screenshot
termtweet "Here's my app's new UI:" --image ./screenshots/new_ui.png

# Quick updates
termtweet "Pushed to GitHub. Time for coffee! ☕ #devlife"

# During development
termtweet "Fixed that pesky bug! Now onto the next challenge 🎯"

# From any project directory
termtweet "Working on something awesome!" -i screenshot.png

🔧 Twitter API Setup

Step 1: Create Twitter Developer Account

1. Go to Twitter Developer Portal
2. Sign up for a developer account if you don't have one
3. Create a new project/app or use an existing one

Step 2: Configure App Permissions (CRITICAL)

This is the most important step - without it, tweets will fail!

1. In your app settings, go to "App permissions"
2. Change permissions from "Read" to "Read and write"
3. Change "Type of App" to "Web App, Automated App or Bot"
4. Fill in the required "App info":
   • Callback URI / Redirect URL: http://localhost
   • Website URL: Your website or https://github.com/yourusername
   • Organization name: Your name or project name (optional)

Step 3: Generate API Tokens

1. Go to "Keys and tokens" section
2. Generate/copy these credentials:
   • API Key (Consumer Key)
   • API Secret (Consumer Secret)
   • Access Token
   • Access Token Secret
   • Bearer Token

Step 4: Configure TermTweet

Use the interactive setup:

termtweet --setup

Or manually create ~/.termtweet/.env with:

TWITTER_API_KEY=your_api_key_here
TWITTER_API_SECRET=your_api_secret_here
TWITTER_ACCESS_TOKEN=your_access_token_here
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret_here
TWITTER_BEARER_TOKEN=your_bearer_token_here

Step 5: Test Your Setup

termtweet --test
termtweet "Hello World! #TermTweet"

⚠️ Common Issues & Solutions

Problem	Solution
"403 Forbidden"	Change app permissions to "Read and write"
"Authentication failed"	Regenerate tokens after permission change
"Missing credentials"	Run termtweet --setup
"Tweet too long"	Keep under 280 characters

🔒 Security & Best Practices

• Never commit .env files to version control
• Keep API credentials secure and private
• Regenerate tokens if compromised
• Use environment variables for sensitive data

🐛 Troubleshooting

Issue	Solution
"Missing Twitter API credentials"	Run python setup.py or check .env file
"403 Forbidden"	Ensure app has "Read and Write" permissions
"Authentication failed"	Verify all credentials in .env are correct
"Image file not found"	Check image path and ensure file exists
"Tweet too long"	Keep tweets under 280 characters

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Tweepy - Python Twitter API library
• Inspired by developers who tweet from the terminal

---

Happy tweeting from your terminal! 🐦