https://github.com/cypher-o/media_muse

An application that allows users to playback media files with a comprehensive set of controls and features.
https://github.com/cypher-o/media_muse

Last synced: 24 days ago
JSON representation

An application that allows users to playback media files with a comprehensive set of controls and features.

• Host: GitHub
• URL: https://github.com/cypher-o/media_muse
• Owner: Cypher-O
• License: mit
• Created: 2024-06-27T10:23:34.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-08-15T10:12:38.000Z (4 months ago)
• Last Synced: 2024-08-16T09:05:53.216Z (4 months ago)
• Language: Python
• Homepage:
• Size: 1.51 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Media Muse App

This Python-based Media Muse application allows users to playback media files with a comprehensive set of controls and features. It integrates with the VLC media player for robust media handling and provides an intuitive interface for managing playlists, subtitles, and playback options.

## Features

- **Media Playback:** Play, pause, stop, skip, and control volume.

- **Fullscreen Mode:** Toggle fullscreen for immersive viewing.

- **Playlist Management:** Create, edit, and manage playlists.

- **Subtitle Support:** Select and manage subtitles during playback.

- **Recent Media:** Quickly access recently played media files.

- **Toolbar and Menu Options:** Extensive toolbar and menu for easy navigation and control.

- **Visual Feedback:** UI elements provide clear feedback on media state and playback controls.

- **Keyboard Shortcuts:** Convenient keyboard shortcuts for common actions.

- **Preferences:** Customize player settings and preferences.

### Prerequisites

- Python 3.x

- PyQt5 library (`pip install PyQt5`)

- VLC media player (`pip install python-vlc`)

## Installation

1. Clone the repository:

    ```sh

    git clone https://github.com/Cypher-O/media_muse.git

    cd media_muse

    ```

2. Install dependencies:

    ```sh

    pip install -r requirements.txt

    ```

## Usage

To run the application, use the following command from the project directory:

    ```sh

    python main.py

    ```

## How to Use

1. **Playing Media:**

    - Open media files using the File menu or drag and drop onto the player.

    - Control playback using buttons for play, pause, stop, skip forward/backward.

2. **Fullscreen Mode:**

    - Toggle fullscreen mode using the fullscreen button or keyboard shortcut (F).

3. **Managing Playlists:**

    - Access and manage playlists using the Playlist button in the UI.

    - Add, remove, and reorder media files in the playlist.

4. **Subtitle Selection:**

    - Choose subtitles from available tracks using the Subtitle dropdown menu.

    - Customize subtitle settings and appearance as needed.

5. **Recent Media:**

    - Quickly access recently played media files from the Recent Media menu.

## Contributing

Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Screenshots

    

        

            

            
Main Interface

        

        

            

            
Fullscreen Mode

        

        

            

            
Playlist View