CrossTalk PM: Bridging Communities with Automated Cross-Platform Notifications. Explore how CrossTalk PM leverages public mentions to enhance engagement across diverse online spaces, promoting a more interconnected and informed user experience.
 
Go to file
j 70b2e63873 Clarified bot owner in messages 2024-06-16 22:23:48 -04:00
src Clarified bot owner in messages 2024-06-16 22:23:48 -04:00
tests/api Addtl Testing Logic 2024-03-17 23:23:37 -04:00
.gitignore excluded a few more file types and a the dist folder 2024-02-22 01:21:19 -05:00
README.MD Expanded Readme 2024-03-23 01:21:23 -04:00
package-lock.json Update package-lock.json 2024-03-18 03:52:32 +00:00
package.json Update package.json 2024-03-18 03:52:45 +00:00
tsconfig.json Messages Handling 2024-02-27 01:39:51 -05:00
tsconfig.tests.json Supporting Testing Configuration 2024-03-17 14:06:41 -04:00

README.MD

CrossTalk PM

CrossTalk PM serves as a digital intermediary, facilitating connections and communications between users from distinct online platforms. It primarily focuses on identifying mentions of Reddit usernames in external platforms like rDrama and subsequently, notifying the mentioned Reddit users. This endeavor aims to foster a seamless information exchange and enhance inter-community interactions.

Key Features

  • User Mention Monitoring: CrossTalk PM diligently scans specified platforms for Reddit usernames being mentioned, ensuring no significant mention goes unnoticed.
  • Automated User Notifications: Upon detecting a mention, it autonomously initiates a Reddit chatroom or dispatches a private message to the mentioned user, thereby alerting them.
  • Adherence to Privacy: The application is designed with a strong commitment to privacy, processing only publicly disclosed information and adhering to privacy norms.

Getting Started

Below you'll find everything you need to know to get CrossTalk PM up and running.

Prerequisites

Ensure you have the following installed:

  • Node.js (version 14 or later is recommended for optimal compatibility)
  • Redis server (for caching and message queuing functionalities)
  • Drama Harvester https://fsdfsd.net/J/DramaHarvester

Installation Steps

  1. Clone the Project:
    git clone https://fsdfsd.net/J/CrossTalkPM.git
    
  2. Navigate to the Project Directory:
    cd CrossTalkPM
    
  3. Install Dependencies:
    npm install
    
  4. Set Up Environment Variables: Create a .env file in the root of your project directory and populate it with the necessary configuration as shown below:
    REDIS_HOST=127.0.0.1
    REDIS_PORT=6379
    # REDIS_PASSWORD=optional (uncomment if applicable)
    RDRAMA_API_KEY=your_rdrama_api_key_here
    redditClientId=your_reddit_client_id
    redditSecret=your_reddit_secret
    redditUsername=your_reddit_username
    redditPassword=your_reddit_password
    EXCLUDE_EMPLOYEES=True
    EXCLUDE_MODS=True
    KARMA_THRESHOLD=100000
    NOTIFICATION_COOLDOWN_HOURS=1
    

Running CrossTalk PM

To activate CrossTalk PM, execute the following command within the project's root directory:

npm start

Upon launch, CrossTalk PM will commence its operation, scanning for user mentions and facilitating notifications through Redis.

Contributing

We highly value and appreciate contributions from our community. Whether it's through submitting bug reports, requesting new features, or contributing directly to the codebase, your involvement is encouraged.

How to Contribute:

  1. Fork the repository.
  2. Create your feature branch (git checkout -b feature/YourFeature).
  3. Commit your changes (git commit -am 'Add YourFeature').
  4. Push to the branch (git push origin feature/YourFeature).
  5. Create a new Pull Request.

License

CrossTalk PM is made available under the MIT License.