motify

Motify

A powerful and modern music downloader and manager application built with Python.

✨ Features

• 🎯 Search and download music from multiple sources
• 🎨 Modern and customizable UI with multiple themes
• 📑 Smart playlist management and queue system
• 🎵 High-quality audio downloads with format selection
• 📊 Download history and statistics tracking
• 🎤 Integrated lyrics support
• 🔄 Concurrent download capabilities
• 📱 Desktop notifications
• ⚡ YouTube integration
• 🎯 Duplicate detection and skip functionality

🚀 Installation

Prerequisites

• Python 3.10 or higher
• pip (Python package manager)
• Spotify Developer Account for API access
• Git (for cloning the repository)

Setup Methods

Method 1: Direct Download

• Download the latest release from the Releases page
• Extract the downloaded zip file
• Navigate to the extracted directory

Method 2: Clone Repository

• Clone the repository:

git clone https://github.com/mosh3eb/motify.git
cd motify

Installation Steps

• Create and activate a virtual environment (recommended):

# On macOS/Linux
python3 -m venv venv
source venv/bin/activate

# On Windows
python -m venv venv
.\venv\Scripts\activate

• Install dependencies:

pip install -r requirements.txt

• Set up your Spotify credentials:

  • Go to Spotify Developer Dashboard
  • Create a new application
  • Copy your Client ID and Client Secret
  • Add http://localhost:8888/callback as a Redirect URI in your Spotify app settings

• Create a copy of the example configuration:

cp app_config.example.json app_config.json

• Configure your Spotify API credentials in app_config.json

Running the Application

• Activate the virtual environment (if not already activated):

# On macOS/Linux
source venv/bin/activate

# On Windows
.\venv\Scripts\activate

• Launch the application:

python run.py

📱 Usage

Main Features

• Search Tab: Search for tracks, albums, or artists
• Queue Tab: Manage your download queue
• History Tab: View download history and statistics
• Lyrics Tab: View synchronized lyrics
• YouTube Tab: Search and download from YouTube
• Settings Tab: Customize application settings

Keyboard Shortcuts

• Ctrl/Cmd + F: Focus search
• Ctrl/Cmd + Q: Clear queue
• Space: Play/Pause current track preview
• Esc: Clear search

🏗️ Project Structure

src/
├── services/         # Core services (downloader, Spotify)
├── ui/              # User interface components
└── utils/           # Utility functions and configurations

🛟 Support

If you encounter any issues or have suggestions:

• Check the existing issues on GitHub
• Open a new issue with a detailed description
• Include your system information and logs

🤝 Contributing

• Fork the repository
• Create your feature branch (git checkout -b feature/AmazingFeature)
• Commit your changes (git commit -m 'Add some AmazingFeature')
• Push to the branch (git push origin feature/AmazingFeature)
• Open a Pull Request

📝 License

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

🙏 Acknowledgments

• Spotify API for music data
• Python community for amazing libraries
• Contributors and users of Motify

🔧 Deployment

Local Deployment

• Follow the installation steps above
• Configure your settings in app_config.json
• Run the application using python run.py

System-wide Installation (Optional)

On macOS

• Create an application bundle:

pip install py2app
python setup.py py2app

• Move the created .app file to your Applications folder

On Windows

• Create an executable:

pip install pyinstaller
pyinstaller --onefile --windowed --icon=resources/icon.ico run.py

• The executable will be created in the dist directory

On Linux

• Create a desktop entry:

sudo cp resources/motify.desktop /usr/share/applications/
sudo cp resources/icon.png /usr/share/icons/hicolor/256x256/apps/motify.png

Docker Deployment (Optional)

• Build the Docker image:

docker build -t motify .

• Run the container:

docker run -d \
  -v ${PWD}/downloads:/app/downloads \
  -v ${PWD}/app_config.json:/app/app_config.json \
  -e DISPLAY=${DISPLAY} \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  motify

Made with ❤️ by Mosh3eb